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Preface 


This publication is for the VM/370 System Programmer 
installing the VM/370 Networking PRPQ (herein referred 
to by the contraction, ““WNET’’), the VNET System Oper- 
ator, and the VM/370 Terminal user using the VNET 
facility. It describes: 
e The concept of Network Job Interface (NJI). 
e The VNET system’s features, components, and opera- 
tion. 
e How to install a VNET system. 
e@ How to operate a VNET system. 
e How a VM/370 virtual machine user makes use of the 
VNET facility. 
The publication contains four parts and three appen- 
dices. 


Part 1: Introduction contains three sections: 

“Overview of NJI’’ presents an explanation of the Net- 
work Job Interface (NJI) concepts and a description of 
the characteristics and operation of an NJI network. 

““VNET Virtual Machine” describes the features and 
operation of a VM/370 virtual machine using VNET as the 
operating system. 

“Components of a VNET System” describes the func- 
tions and relationships of the major components of a 
VNET system. 


Part 2: VNET Installation discusses installation planning 
considerations and describes the installation procedure. 


Part 3: VNET System Operation contains two sections: 
“Operation Description” discusses general operation, the 
operator commands, and the operator messages. 
“Operation Procedures” describes how to start, stop, 
change, and control the VNET system. 


Part 4: VM/370 User Guide explains the commands and 
messages available to the VM/370 user and their use in 
working with VNET. 


Appendix A: VNET Commands contains detailed descrip- 
tions of the commands available to the VNET operator. 
The subset of those commands available to the remote 
station operator are also identified. 


Appendix B: VNET Messages Summary contains a listing 
of all the VNET messages and responses tabulated by the 
command or function that initiated the message. A key to 


the distribution of each message or response is also included. 


Appendix C: Remote Terminals and Stations contains two 
parts: 

The first part on nonprogrammable remote terminals 
contains a section on each of the nonprogrammable re- 


mote terminals supported by VNET. Each section covers 
the configuration of the terminal, establishing the line 
connection, terminal operation, and error recovery pro- 
cedures. 

The second part on MULTI-LEAVING remote stations 
contains a section on each of the programmable remote 
stations supported by VNET acting as a host, and a sec- 
tion on VNET acting as a job entry station to a remote 
HASP/ASP batch system or its equivalent. Each section 
covers the supported configuration of the station, 
establishing the line connection, station operation, and 
error recovery procedures. 
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IBM Virtual Machine Facility/370: CMS Command and 
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PART 1: INTRODUCTION 


Part 1 is an introduction to Network Jok 
Interface (NJI) and the VM/370 Networking 
PRPQ (VNET). The following topics are introduced: 


e Overview of NJI 
e The VNET Virtual Machine 
e Components of a VNET System 
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2 VNET Reference and Operations 


OVERVIEW OF NJI 


Network Job Interface (NJI) is a method of creating a unified job 
network. The network consists of a mix of IBM System/370 processors, 
running applicable operating systems. Any processor on the network can 
send job or data files through the network to another processor. The 
receiving location can be the adjacent link in the network or it can be 
several processors (nodes) removed from the source location. 


NJI makes possible the use of all resources in the network by enakling: 


1. Input cf jobs or data files at any point, including local input 
devices, remote job entry stations, and time sharing terminals. 


2e Automatic transmission of the joks and data through one or more 
processors (network ncdes) to a particular location for 
processing. 


3% Trarsmission of batch job output back to the originating point or 
to other foints as requested. 


NJI CHARACTERISTICS 


All System/370 systems with NJI capability present a common set of 
interfaces to remotely ccnnected systems. The method in which these 
common external characteristics are implemented depends upon the 
particular systems. In general, all NJI compatible systems share the 
following functions: 


e Store and Forward - A system receives and temporarily stores a 
complete file in its cwn spooling facility before sending the file 
on to the next node in the network. 


e Symmetric Protocol - Card and printer formatted data streams are 
transferred from system to system with neither system assuming a 
subordinate role. 


e Automatic Routing - Takles created at system initialization time 
enakle the system to examine a file and determine if the file 
destination is local or remote. If the destination is remote, the 
file is passed on withcut requiring operator intervention. 

e Operator Commands - System operators may manually query and control 
network processing. [Lynamic alteration of node status, routing 
tables, and status or disposition of files are permitted. 


The VM/370 Networking PRPQ (VNET) includes the common characteristics 


listed akove in addition tec further features. Both are explained in 
more detail in the discussion of the VNET Virtual Machine. 


NdI NETWORK MEMEFERS 


Four different types of systems can communicate and operate as members 
or nodes of an NJI network. VM/370 REL. 3, ASP 3.2, HASP II 4.0 and the 
JES2/NJE (Network Job Entry Facility For JES2). 
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NJI consists of three comrronents: VM/370 Networking PRPQ (VNET), ASP 

Networking PRPQ, and HASP Networking PRPQ. Each contains enhancements 

and modificaticns to the respective system programs to perform job 2S) 
networking functions. A specific system becomes a member node of an NJI 

network after installing the appropriate NJI or NJE component and the 

necessary communications eguipment. 


Sending, receiving, and intermediate nodes of an NJI network can be any 
combination of the akove mentioned systems. RJE workstations can also 
ke sending or receiving locations. 


NETWORK OPERATION ‘ 


The operation of an NJI unified job network can be explained by 
following a sample file transmission through a network. Figure 1. shows 
a Simple NJI network. If we assume the teleprocessing link between 
System EB and System D is temporarily unavailable, any file from System B 
destined for System C must pass through System A. 


A user on System B wishes to transfer a file to a user on System C. The 
sequence of events is as follows: 


1. System B user creates a destination record containing the 
destinaticn location (node) and userid. The user then places the 
file in the System BP spool facility, directing it to the HASP 


Networking facility. ) 


26 The HASP networking facility then takes the file from the spool 
facility, reads the destination record, checks its tables, and 
finds that the only available route to System C is through System 
A. 


Die The HASP networking facility sends the file out through the 
Networking Interface to System A. 


4. Syster A VNET receives the complete file and stores it in the spool 
facility. VNET notifies HASP that the file has keen completely 
recéived. 


5s HASP purges the file from the System B spool facility. System A 
VNET now has responsikility for the file. 


6. VNET determines from the file, and its own tables, the next nede on 
the route to the file destination. 


Te VNET transmits the file to the next node (System C). 


8. System C ASP networking facility receives and stores the file in 
the system spool facility. 


9% ASP then notifies VNET that the file has been ccmpletely received. 


10. VNET purges the file from the System A spool facility. System c 
ASP now has responsikility for the file. 


11. Syster C is the destination system in this example, therefore, the 
ASP networking facility passes the file to the ASP subsystem for } 
processing. 
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In this example System C was the destination system. If it had not 


keen, the transferral process would have keen rereated as often as 
necessary. Each node on a network need only store the file temporarily 
until it is passed to the next node. Each node keeps cnly the 
information in its tables that is necessary to determine the next node 
on the route to each destination for which it handles files. 


All systems (nodes) in an NJI network operate as independent but 
( ccoperating members of the network. 
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VNET VIRTUAL MACHINE 


The VM/370 Networking PRPQ is a virtual machine subsystem for VM/370. 
Together with the Control Program of VM/370, it controls 
telecommunication I/0 devices and lines used to automatically transfer 
files between: 


e VM/370 users and renote stations or other VM/370 users. 
e Remote stations and other remote stations. 
e VM/370 users and remote (one or more nodes) HASP, ASP, 


JES2/NJE systems. 
e Remote stations and HASP, ASP, or JES2/NJE systems. 
e Remote stations and CMS Batch virtual systems. 


VNET runs in a single virtual machine as a telecommunications subsystem 
under VM/370. It functions as an independent cooperating member node of 
an NJI Network. The VNET virtual machine, running under VM/370, 
operates as any other virtual machine. 


VNET is a Single purpcse operating system for a virtual machine, 
dedicated to processing files spooled to it, and transmitting these 
files via communication lines to remote nodes or workstations. The 
telecommunication I/0 facilities to be managed by VNET operate in binary 
synchronous mode and are attached, temporarily or permanently, to the 
VNET virtual machine. Communications via channel-to-channel adapter are 
also supported. See Figure 2 for a representative VM/370 installation 
using VNET. 


When no operator intervention is required, the VNET operator may 
disconnect the VNET console and run in disconnected mode. VNET is 
designed to operate normally without regular operator intervention. When 
disconnecting his console, the VNET operator has the option of 
specifying another virtual machine console (typically the system 
operator's console) to receive any VNET console output. When not in 
disconnect mode, the VNET operator can use the console to enter VNET 
ccmmands to alter normal processing and to monitor network activity. 


MAIN FEATURES 


The VM/370 Networking PRPQ (VNET) incorporates all of the features 
included in the Remote Spooling Communications Subsystem (RSCS) 
component of VM/370 (see Preface for related publication). Significant 
features have keen added that simplify system operation and provide 
compatibility within an NJI unified jcb network. These features are 
explained in this section. 
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Figure 2. Representative VNET Installation 
STORE AND FORWARD 


The store and forward function occurs automatically using an output file 
tag created by VNET at the receiving system. The tag on the incoming 
file is read by the spool access manager in the local VNET system to 
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determine the file destination. If the destination is not local the file 
is spooled and then enqueved on the next destination link by VNET. 


Once transmission of a file frem one system to another has been 
completed, the receiving system assumes full resonsikility for the 
integrity and recovery of the file in the event of a network or system 
failure. This is accomplished by the use of the system's spool file 
facility, thus utilizing each system's provisions for integrity and 
recovery. 


AITERNATE PATH FACILITY 


VNET automatically (without oferator intervention) performs NJI indirect 
routing. Each file received ky VNET includes a destination location 
(node) name. If the specified destination is local the file is passed 
to the specified local user virtual machine or to the local system 
facility for real processing. If the destination is remote the file is 
queued on the link that is locally specified as the proper route to the 
destination location. This process is automatic unless overridden by 
lecal operator commands. 


A further refinement enables VNET to dynamically alter its routing in 
response to a change in network status. Each time a transmission link is 
activated or deactivated, defined or deleted, all of the inactive input 
files are passed through a "selector", This process provides automatic 
alternate rerouting of the files from a direct to an indirect path in 
the event of a direct link deactivation. 


SYMMETRIC PROTOCOL 


VNET conforms to the symmetric protocol, as defined Ly the Network Job 
Entry Facility for JES2 program protocol, by communicating with other 
system nodes on the NJI network on an equal basis. The host-workstation 
relationship is not required. 


Symmetric protocol is implemented in VNET through. the design and 
selection of the line drivers. Each communication link in VNET uses the 
line driver that is compatible with the protocol used by the remote 
system. VNET Simplifies the establishment of a new communication link ky 
providing a selection of line drivers compatible with all NJI supported 
system nodes, as well as specialized communication facilities for 
communication with other VNET systems. 


VNET OPERATOR CONTROL 


Operator commands are provided tc permit manual intervention to control 
the NJI network. Status and disposition of files can ke changed in 
response to locaj. conditions. Node status and routing tables can be 
dynamically altered. Operator commands may be entered locally and passed 
on to any other node for processing. Any response is returned to the 
local console. 


EXEC FACILITY 


This facility is similar to the CMS "EXEC" function. It is used by the 
VNET operator to call out a frequently used series of commands such as 
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those used to automatically change a network configuration at a 
particular time of day. It can also be used at VNET IPL time, in 
ccnjunction with the auto-logon facility available in VM/370, to 
automatically start up VNET links operating over leased lines. 


ACCOUNTING RECORD PROVISION 


An accounting record is generated by the AXS (Spool access manager) task 
each time an input or output spool file is closed. In the case of input 
spool files, records are generated only if the sfool file originated 
from the local node. 


The record contains the following fields: 


had 


Originating User IL ----------- 8 bytes 
Time and Date ---------------- 12 bytes 
Local Spool File ID------------ 2 bytes 
Origin Spool File ID----------- 2 bytes 
Originating Location ID ------- 8 bytes 
Originating VM/370 Device Type- 1 byte 

Lestination Location ID ------- 8 bytes 
Destination Userid ------------ 8 bytes 
Spool File ClaSS -----<--------- 1 byte 

Number of Records in File ----- 4 bytes 
Destination Location User ID -- 8 bytes 


Most of the data is obtained from the spool file tag. Time and date 
information is oktained from VM/370. This record is processed through 
the standard VM/370 user accounting interface. 


SAMPLE FILE TRANSMISSION 


In order to provide an overall understanding of the operation of a VNET 
virtual machine a sample file transmission is descriked in this section. 
Figure 3 is a simple NJI network composed of three VNET virtual machines 
running under three VM/37C systems. The description refers to AXS (the 
VNET spool access manager) and VMB and VMC (the line driver tasks). In 
the following steps a file is followed from submission by a VM/370 CMS 
terminal user through to arrival at the destination location. The major 
steps in the operation are keyed to Figure 3 (A,B,C,D,E). 


RECEIVING A FILF FROM SOURCE (A) 


The CMS virtual machine user (user1) issues two commands to VM/370 CP: 


SEOOL OOD TO VNET 
TAG DEV 00D 370C USER2 


The user then issues a PUNCH command to CMS. VM/370 CP builds a file of 
"punched" output for CMS with a tag of 370C USER2. VM/370 CP then 
notifies its virtual machine, VNET 370A, that a file is waiting via an 
interrupt to the spool access manager task AXS in VNET 370A. AXS then 
builds the file tag in a tag slot for reference. 
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SENDING FILE TO NEXT NODE (B) 


AXS checks the link table for a link 370C (from the tag of 370C USFR2). 
It finds no link 370C. It checks the route table for a route 1isting 
370C. It finds a route entry of 370C with a link of 370B. AXS enqueues 
the file on the line driver VMB on the link to 370B. AXS "alerts" VMB 
of the link to 370B that a file is waiting for transnission. VMB 
accepts the file by a give/take call to AXS. AXS sets up a virtual 
reader, tells VM/370 CP to direct the file to that reader, then gives 
centrol of the reader to VME. VMB kegins to read, format (if 
necessary), and transmit tke file to VNET 370B. 


FILF STORF-AND-FORWARD (C) 


The line driver VMB of VNET 370B recognizes the beginning of a file 
arriving. VMB of VNET 370E issues a give/take call to AXS of VNET 

370B. AXS checks the tag on the incoming file and puts it in an 
incoming tag slot for reference. AXS sets up a virtual punch for VME to 
use in buildirg an output spool file. Since the destination tag of 370C 
did not match the local identification of 370B, an S&F (store and 
forward) tag is placed on the file. When an “end-of-file" character is 
received by VME of VNET 370B, it issues a closing output give/take call 
to AXS of VNET 370RB. AXS closes the file and directs it to VNET 370B 
(itself). AXS notifies VME cf completion and VMB of 370B sends an “ACK" 
to VMB of 370A. VMB of 370A issues a close input give/take call to AXS 
of 370A. AXS then purges its ccpy of the file. VNET 370B now has 
responsikility for and the only copy of the file. VM/370 CP of VNET 
370B system notifies VNET 370B by an interrupt to AXS of VNET 370B that 
a file is waiting for transmission. AXS stores the file tag ina slot 
for reference and checks its link takle for a link 370C. It finds a link 
370C. AXS enqueues the file on the line driver VMC of the link to VNET 
370C. AXS then "alerts" vMc that a file is waiting fcr transmission. The 
transmissicn procedure from this point is the same as steps 7 through 9 
in Figure 3. 


ACCEPTING FILE AT DESTINATICN NODE (DL) 


The reception of the file at the destination node (VNET 370C) is the 
Same as steps 9 through 11 except that the file is recognized as being 
for this location and therefore is not tagged for store-and-forward. It 
is spooled to the end user (USER2) rather than back to VNET. 


PASSING FILE TO END USER (E) 


AXS of VNET 370C spools tke file to the input reader of USER2. VNET 
370C issues a message to USER2: 

DMTAXM1041T FILE (1234) SPOOLED TO USER2-- 

ORG 370A (USER1) O2/14/77 05:49:11 
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COMPATIELE NOLES 


A remote node, in the context of VNET, is any terminal or system on the 
other end of the link from the VNET virtual machine. The VNET virtual 
machine is also called the local VNET location. VNET is compatible with 
three types of remote system nodes and two general types of I/0 
configurations used as remote stations. 


VNET is compatible and can communicate with the following remote system 
nodes: 


e A HASP II Version 4.0 system having the HASP Networking PRPQ 
modifications and enhancements. 


e An ASP 3.2 system having the ASP Networking PRPQ rodifications 
and enhancerents. 


e A JES2 system with the Networking Job Entry facility for JES2 
(NJE) Program Product. 


The two types of compatikle remote stations are nonprogrammable and 
programmatle. 


Nenprogrammable remote terminals, such as the IBM 3770, are I/0 
configuraticns that are hard-wired to provide the line protocol 
necessary for them to function as remote stations. These devices are 
managed by the Nonprogrammakle Terminal (NPT) line driver of VNET. 


Programmable remote stations, such as the IBM System/3 and System/370, 
are IBM processing systems with attached kinary synchronous 
communications adapters. These systems must be programmed to provide the 
MULTI-LEAVING line protocol necessary for their I/0 devices to function 
as remote stations. This programming support is provided by a Remote 
Terminal Processor (RTP) program that is generated according to HASP 
workstation protoccl and tailored to the system's hardware 
configuration. Certain programmable remote stations like the System/3 
can only be programmed to function as remote terminals. Others, like 
the System/360 and System/370, can function either as remote terminals 
or as host katch systems using VNET as a remote job entry workstation. 
Beth of these types of remote stations are managed by the Spool 
MULTI-LEAVING (SML) line driver of VNET. 


All stations, remote and local, must ke assigned a one- to 
eight-character (alphameric) lccation identification. This 
identification usually suggests the physical location of the station 
(HOUSTON, DEPT14, PLDG76, ACCNING, FLOOR1 are typical examples). 


VNET provides rultiple ccncurrent line management support for a specific 
number of remote stations of the various supported types, dependent on 
tke virtual storage size of the VNET virtual machine. 


VNET LINK ATTRIBUTES 


A link is defined as a potential path for data transmission between a 
VNET virtual machine and an adjacent, uniquely identified remote 
location. A group of parameters describing the attributes of a link is 
called a link definition. These attrikutes include the following: 


linkid - a one- to eight-character (alphameric) link identifier, 


identical to the location identifier of the remote station 
associated with the link. 
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type - a one- to eight-character (alphameric) name designating the 
module name of the line driver to be used to manage the 
transmission. 


line - a virtual device address of a communication adapter port for 
exclusive use by this link. If not specified, VNET assigns the 
link a switched telecommunication port when the link is 
activated. 


class - the designation of the classes of files that may be processed 
by the active link. The default value of class is ‘all 
classes'!,. 


VNET maintains a table of link definitions that are set up at VNET 
system generation time. This is called the VNET link table. Link 
definitions may be temporarily added, deleted, or modified using the 
VNET operator commands, DEFINE and DELETE. When a link is activated, the 
opticnal operands of the START command may also be used to override the 
link attrikutes. (For additional information see DEFINE, DFLETE, and 
START under "VNET Operator Commands"). These definitions may Le 
permanently changed through modification of the VNET directory. 


VM/370 SEOOL SYSTEM INTERFACE 


All VM/370 output spool files contain a 136-byte tag field located in 
the file's first spool Luffer. The format and contents of the tag field 
vary according to its intended use. Tag information, to be associated 
with a particular spool output device, is entered by a VM/370 user via 
the TAG DEV command. The tag data entered via the TAG DEV command is 
stored in an area associated with the virtual device specified. When 
the first spool file data record is to be written, a tag field of 136 
blank bytes is initialized in the first spool buffer of the file. When a 
file is closed, the tag is accessed, tag data is retrieved from the 
storage area and inserted, and the tag is rewritten. 


When the TAG command is issued by a VM/370 user to tag a file destined 
for transmissicn by VNET, the first tag data entry must be the location 
identification of the remote station that is to receive the file. For a 
full description of the TAG command, see "VM/370 User Commands" in Part 
Wu. 


All spool files to be transmitted by VNET must ke spooled to the VNET 
virtual machine by the VM/370 user or entered from the real card 
reader. 
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VNET consists of a multitasking supervisor, system control tasks, and 
line driver tasks. Figure 4 shows the major components of a VNET 
System. 
VM/370 NETWORKING VIRTUAL MACHINE SUBSYSTEM 
ea MSUP 
Multitasking 
Supervisor 
$ 
Rex 
. AxS LAX 
Main VNET Spool Access Line Access 
Subsystem Manager Manager 
Control Taste Task 
Task 
Q 
NPT SML NJE 
Line Line Line 
Driver Driver Driver 
Task Task Task 
Cc Figure 4. Components Of a WM/370 Networking Virtual Machine Subsystem 
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The VNET supervisor supports multiple system control and line driver 
tasks that may ke active at any one time. This includes multitask 
dispatching, the management of virtual I/O devices used by VNET, and the 
management of virtual storage required ky each task. 


SYSTEM CONTROL TASKS 


The system control tasks provide common services to the line driver 
tasks and provide communication with the VNET operator. These services 
include command execution, message distribution, program check handling, 
VM/370 spool system interface, and communication line allocation. 


LINE DRIVERS 


Fach line driver task manages the transmission of files to and froma 
single remote node or workstation and provides a communication link for 
remote operator commands. Cue to functional and hardware differences in 
remote system and terminal equipment, each line driver is written to 
feupport a specific class of remote node. 


SPOOL MULTI-LEAVING (SML) LINE DRIVER 


MULTI-LEAVING is a term used to describe a communication technique used 
by the SMI line driver operating under VNET. Basically, physical records 
that are input to MULTI-LEAVING are reduced to a series of character 
strings of two basic types: a variable length non-identical series of 
characters, and a variakle numker of identical characters. The 
segmentaticn of physical records into these character strings takes 
advantage of identical character compression. Multiple physical records 
(now in the form of character strings) are grouped into a single 
transmission block. The MULTI-LEAVING design provides for a 
bidirectional interleaved exchange of transmission blocks, each 
containing multirfle data streams. For a detailed description of 
MULTI-LEAVING see VM/370 Networking PRPQ, Program Logic Manual. 


The SML line driver, operating as a task under VNET provides VM/370 with 
Support of MULTI-LEAVING, L-inary synchronous communications (BSC) line 
protocol for programmable remote stations. This enables: 


e VM/370 users to have remote job entry access to HASP/ASP-type batch 
processing systems. 


e Remote stations to sukmit source decks, data, and ‘jobs, on cards, 
into the VM/37C spool system. 


e VM/370 to send spooled output of virtual machine sessions to remote 
card punches and printers. 


e Transmission of card decks ketween two remote stations supported by 
VNET. 
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e Remote stations to send job streams to a CMS Batch virtual machine 
(operating under the same VN/370 as VNET) and have the output 
returned to the originating or another remote station. 


e Remote stations to sukmit source decks, data, and jobs, on cards, to 
another remote location running a HASP or ASP type batch processing 
systems. 


e Remote stations to sukmit data files or a job to any system in the 
NJI network and receive jok output at the remote station. 


The following systems support MULTI-LEAVING RJE operation: 


HASP II Version 4 (370H-TX-001) 

ASP Version 3.2 (360A-CX-15X) 

JES2 Component of VS2 Release 2 and above 
JES3 Component of VS2 

RES Component of VS1 Release 2 and above 


Hardware Products Supported 


The following systems are supported by the SML line driver as remote job 
entry stations into VM/370: 


IBM System/360 Models 20, 22, 25, 30, 40, 50, 65, 75, 85, 195 

IBM System/370 Models 115, 125, 135, 135-3, 138, 145, 145-3, 148, 
155, 155 II, 158, 165, 165 II, and 168 

IBM 1130 System 

IBM System 3 Models 6, 8, 10, 12, and 15 

IBM 2922 Programmable Terminal 

IBM 3777 Communication Terminal Model 2 (as a System/360 Model 20 
MULTI-LEAVING Workstation) 

IBM System/32 


When the SML line driver is operating as a remote job entry access 
System to a HASF/ASP-type processor, it communicates with any IBM system 
that supports the HASP/ASP MULTI-LEAVING transmission protocol. 


Supported Functions 


The SML line driver, operating under the control of the VNET supervisor, 
functions in one of two modes, specified at the time the line driver 
task is initialized: 


RJE Mode: where the SML line driver functions as a job entry workstation 
to a remote HASP/ASP-type processor. 


HOST Mode: where the SML line driver functions as the host to a remote 
MULTI-LEAVING programmable station. 


Each SML line driver task controls a single communication line, or 

link. The task is started by the VNET operator, identified with a 
destination nare, and provided with a leased or switched telephone line. 
The communication line is identified either by the VNET operator in the 
START command or derived from a table entry in VNET. On a switched line, 
a dial-up procedure fren either end of the line establishes the 
connection. 
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The SML line driver operates with a slightly modified protocol depending 
on whether it is operating in RJE or HOST mode. In RJE mode, the type of 
remote host system, as designated in the START command or link parameter 
information in the VNET directory, determines the prcetocol to be 
followed. In HOST mode, the SMI line driver follows a common protocol 
for all remote stations. The functional support is described below in 
the following categories: 


VNET operator functions 

Remote station operator functions 
Virtual machine user functions 
Input/output control 

Line allocation 


VNET Operator Functions 


The VNET operator controls the initialization and termination of the SML 
line driver task. He controls the spool files enqueued on his virtual 
reader in much the same way as the VM/370 system operator controls the 
spooling functions of VM/370. He can send or receive messages to and 
from the remote stations ccntrolled by the SML line driver. Using the 
TRACE command, he can monitor the activity on the communications line 
and have that data logged on his operator console. 


If the SML line driver is in RJE mode, the VNET operator can use the CMD 
ccmmand to send any allowaktle workstation commands to the remote host 
system that is processing the data. 


Remote Operator Functions 


If the remote station is a HASP/ASP system (SML line driver in RJE 
mode), its functions with respect to the SML line driver are the same as 
they they would be for any other HASP/ASP remote workstation. It accepts 
job streams for batch processing or commands affecting the processing 
from the SML line driver and directs jok output, in punch or printer 
format, kack to the SMI line driver. 


When SML is in HOST mode, the remote station operator has the ability 
=O% 


e Issue ccmmands to the SML line driver to affect changes in the 
operation of his remote station. 


e Provide a batch service, transmitting jobs to and receiving output 
from a katch virtual machine (OS, CMS BATCH, VM/370). 


e Transmit and receive card decks through the SMI line driver to and 
from another remote station supported by VNET and attached to the 
same VM/370 system. 


e Transmit joks and commands to a remote batch system through VNET 


using the Network Job Interface (NJI) and direct job output to any 
node or remote station in the network. 
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Virtual Machine User Functions 


When the SMI line driver is in RJE mode, the VM/370 user can submit job 
streams to a remote HASP/ASP type batch system. Punch and/or printer 
output, returned to the SMI line driver, is directed to the real frinter 
and punch. 


When the SML line driver is in HOST mode, the VM/370 user can route the 
output of his virtual unit record devices to a remote MULTI-LEAVING 
programmable station. He can also have a card deck entered at a remote 
station and have it directed to his virtual machine reader. 


Input/Output Control 


The SML line driver uses tke VNET supervisor I/O services to perform 
input/output operations on the BSC line to the remote terminal and to 
centrol the virtual reader and punch. The SML line driver uses the VNET 
Supervisor console support facility to write messages to and receive 
commands and information from the VNET operator. 


SML line driver communications I/O comprises five separate operations: 


1. Control of the line when the task is idle. When the SML line 
driver reads the telecommunications control unit with a three- 
second timeout, the timeout is used to force periodic checking for 
the arrival of spool files to send. 


2. Transmission procedure for sending files to the remote station. 
3. The procedure for receiving files from the remote station. 


4, Error analysis and recovery while transmitting to the remote 
station. 


5. Error analysis and recovery while receiving from the remote 
Station. 


All input/output operations are executed following the 270x BSC protocol 
for the type, configuraticr, and features of the remote station as 
determined at task initialization time. 


Line Allocation 


The Line Allocator in the VNET supervisor allocates an appropriate line 
to the SML line driver during execution of the VNET START command. The 
line has either been designated ky the operator in the START command, 
found in the VNET link takle that contains the valid link definitions, 
or selected by the Line Allocator from a pool of switched lines set up 
at VNET system generation. When the SML line driver task requests 
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termination, the VNET supervisor automatically indicates that the line 
can ke reassigned, effectively deallocating it. It is selected from the 
table of available lines ky the allocator the next time a line is 
requested. 


NET LINE DRIVER 


The NPT line driver, operating as a task under the VNET component of 
VM/370, provides VM/370 with support of binary synchronous communication 
{BSC) line pretocol for necnprogrammable remote terminals. This allows: 


e Remote users of VM/370 to enter source decks, data, and jobs, on 
cards, into the VM/370 spool system. 


e VM/370 to send spooled cutput of virtual machine sessions to remote 
card punches and printers. 


e Remote VNET stations to transmit card decks to one another. 


e Remote stations tec send job streams to a CMS Batch virtual machine 
operating under the same VM/370 and have the output returned to the 
remote station. 


e Remote stations to sukmit jobs or commands to any node in the jJjok 
network and direct tke cutput to any node or remote workstation in 
the network. The default is return to origin. 


Hardware Products Supported 


The following devices are supported by the NPT line driver as remote 
ncnprogrammable terminals: 


IBM 2770 Data Communication System with the 2772 Multipurpose Control 
Unit 


IBM 2780 Data Transmission Terminal, Models 1 and 2 


IBM 3770 Data Communication System (nonprogrammable models) operating 
in 2770 BSC mode 


Note: The 3770 is supported only when its communication line 
terminates in an Integrated Communications Adapter (ICA) on the 
System/370 Model 135, an IBM 2701, or an IBM 3704/3705 
Communications Controller. The 3770 keyboard is not supported. 


IBM 3780 Data Communications Terminal 


Supported Functions 


NET is a line driver task operating under the control of the VNET 
Supervisor. Each NPT task can drive one rerote nonprogrammable 

station. In cther words, each NPT task controls a single point-to-point 
communications line. The task is started by the VNET operator, 
identified with a destination name, and provided with a leased or 
switched telephone line. The communications line is either identified 
by the operator or derived from a table entry within VNET. The line is 
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then activated and the type cf remote station and its configuration 
details are obtained from control cards entered at the remote station, 
or from a table entry withir VNET. Once this initialization is 
accomplished, the terminal may then be used to sukmit files via the card 
reader and receive files on the punch and printer. The remote station 
operator can control input/output activity via control cards and 
Standard station procedures. The VNET operator controls the operation 
with interactive commands from his console. The virtual machine user 
retrieves files sent to his virtual machine by using normal virtual card 
reader management programs and directs output to the appropriate station 
using the SPOOL and TAG commands of VM/370. 


NPT operates with variations of the kasic BSC prctocol for each of the 
Stations listed. The protocol is based upon the station identification 
information located in a SIGNON card read at initialization time. NPT 
functions are further described as follows: 


VNET operator functions 

Remote terminal operator functions 
Virtual machine user functions 
Input/foutput control 

Line allocation 


VNET Operator Functions 


The VNET operator controls the initiation and termination of the NPT 
task. He can control the spool files enqueued upon the VNET virtual 
machine in much the same way as the VM/370 operator controls the 
spooling function of VM/370. In addition, he can send and receive 
messages to and from the remote terminals controlled by NPT. Activity, 
on the communications line ccntrolled by NPT, is logged on the VNET 
orerator's console. 


Remote Terminal Operator Functions 


The remote terminal operator can: 


1. Issue commands to NPT to affect changes in the operation of his 
terminal. 


2. Provide a katch service, transmitting jobs to and receiving output 
from a batch virtual wachine such as CMS BATCH. 


3. Transmit and receive card decks, through NPT, to and from another 
terminal supported by VNET and attached to the same VM/370 system. 


4. Transmit jobs, data files or commands to any node on the network 


and direct job cutput to any node or workstation on the NJI 
network. 


Virtual Machine User Functions 
The virtual machine user can: 
1. Route the output of his virtual unit record devices to a remote 


nonprogrammable terminal. 
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2. Have a card deck entered at a remote nonprogrammable terminal and 
have it queued on his virtual machine reader. 


3. Submit a job through VNET from his terminal and have the output 
directed kack to a remote station. 


Input/Output Control 


NPT uses the VNET supervisor I/0 services to perform input/output 
operations on the BSC line to the remote terminal and to control the 
virtual reader and punch. NPT uses tke VNET Supervisor console support 
facility to write messages to and receive commands and information from 
the VNET operator. 


NPT communications I/0 comprises five separate operations: 


1. Control of the line when the task is idle. When NPT reads the 
telecommunicaticns control unit with a three second timeout, the 
timeout is used to force periodic checking for the arrival of spool 
files to send. 


2. Transmission procedure for sending files to the remote station. 
3. The procedure for receiving files from the remote station. 


4, Error analysis and recovery while transmitting to the remote 
station. 


5. Error analysis and recovery while receiving from the remote 
station. 


All input/output operations are executed following the 270x BSC protocol 
for the type, configuration, and features of the remote terminal as 
determined at task initialization time. Separate send and receive 
btuffers previde for the interruption of long output files to allow the 
irput of cards or commands. When the input transmission is completed, 
output transmission is resumed from the point of interruption. 
Transmissicn to a remote punch device is performed in transparency mode, 
if the transparency feature is availakle, while transmission to a remote 
printer is always performed in nontransparency mode with elimination of 
trailing blanks in each record. Print files are always translated in 
order to eliminate illegal characters that would force a transparent 
wait state on a teleprocessing control unit in nontransparency mode. 


Line Allocation 


The Line Allocator in the VNET supervisor allocates an available line to 
NPT as part of the execution of the VNET START command. fThe line has 
either been designated in the START command, found in the VNET link 
table, or selected by the Line Allocator from a fool of switched lines 
set up at system generation of VNET. When the NPT task requests 
termination, the VNET supervisor automatically indicates that the line 
can be reassigned, effectively deallocating it. It is selected from the 
table of availakle lines ky the allocator the next time a line is 
requested. 
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VMB LINE CDRIVER 


This line driver is for the transmission of VM/370 spool files between 
VM/370 VNET facilities over binary synchronous communications lines. 


DMTVMB communicates with arcther copy of itself using the file address 
as specified on the VM/370 TAG command (location, and userid) to 
determine the recipient virtual machine. 


DMTVMB will support both print and punch file transmission between users 
operating on two different VM/370 machines or transmission from a VM/370 
user to a real unit record device on a remote VM/370 machine. 


DMTVMB requires no special operating instructions and sufports the full 
VNET command language except for EACKSPAC, HOLD IMMEL, and FWDSPACE 
count. 


VNC LINE CRIVER 


DMTVMC is a line driver intended for use over a channel-to-channel 
adapter (CTCA) connecting VM/370 machines running VNET. DMTVMC passes 
VM/370 4K spool page tuffers to another copy of itself, using a 
specially designed protocol to optimize utilization of the 
crannel-to-channel adapter without creating heavy I/O activity. The 4k 
block is read from the VM/370 spool system, transmitted across the CTCA 
and then written into the receiving machine's spool system in such a way 
aS to minimize SIO execution. Like DMTVMB, DMTVMC requires no special 
operating instructions, and supports the full VNET command language 
except for BPACKSPAC, HOLL IMMED, and FWDSPACE count. 


NJI LINE CRIVER 


The NJI line driver is designed for communication between VNET and 
Network Job Interface or Network Jok Entry compatitle subsystems uSing 
binary synchronous communication lines or channel-to-channel adapter. 
These systems include HASP II Version 4.0, ASP 3.2, and JES2/NJF. 

DMTNJI supports the same types of file transmissions as DMTVMB. It also 
requires no special operating instructions and supports the full VNET 
ccmmand language except for BACKSPAC, HOID IMMED, and FWDSPACE count. 


VME/SVMC/NII COMMCN FACTORS 


These line drivers, operating as tasks under the VNET subsystem, provide 
for communication from VNET to NJI/NJE compatible suksysters as well as 
other VNET subsystems, over L-inary synchronous communication lines and 
channel-to-channel adapters. This provides VM/370 users capability: 


e to submit jobs to a remote Latch processor for execution. 


e to direct the output from a job to any remote system or back to the 
users virtual machine reader. 


e to route cutput to a remote batch system for processing and take 
advantage of special forms and output processing routines available 
at that system. 
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Products Supported 


The following software preducts are supported as remote systems: 


VM/370 Networking PRPQ 5799-ATA 
JES2 Network Job Entry Facility Program Product 5740-xXR8 
ASP Networking PRPQ 5799-ATE 
HASP Networking PRPQ 5799-ATC 


Supported Functions 


NOJI/VMB/VMC are line driver tasks orferating under the control of the 
VNET supervisor. Each line driver task can communicate with one remote 
system. In cther words, each line driver task controls one 
communication adapter, either a kinary synchronous line or 
channel-to-channel adapter. The functional Support is described below 
in the following categories: 


e VNET operator functions 
e Remote system operator functions 
e Virtual machine users functions 


VNET Operator Functions 


The VNET operator controls the initiation and termination of the line 
driver task. He can control the spool files enqueued upon the VNET 
virtual machine in the same way as the VM/370 operator controls the 
spooling function of VM/370. In addition, he can send commands and/or 
messages to any other remote system. 


Remote System Operator Functions 


The remote system operator can issue commands to effect the operation of 
the file transfer to his location at the directly connected system. 


Virtual Machine User Functions 


Tre virtual machine user can: 


e Route the output of his virtual unit record output devices to any 
remote system for processing. 


e Submit files to execute as jobs at remote batch systems. 


e Receive files entered at remote systems real card readers at his 
virtual machine reader. 


e Have cutput from a jok executed at a remote batch system returned 


to his virtual machine reader, under user control, when this 
function is supported ky the remote batch system. 
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PART 2: VNET INSTALLATION 


Part 2 descrikes the elements involved 
in installing a VNET virtual machine. 
Two main areas are discussed: 

1. Planning for VNET Installation 


2. Installing VNET 
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PLANNING FOR VNET INSTATLATION 


This section describes the procedure for creating the VNET dynamic 
directory which defines your local VNET system and also the guidelines 
used for the selection of line drivers for a particular application. 


THE VNET CYNAMIC CIRECTORY 


Each VNET installation must specify the local definitions and options 
that pertain te its operation. To do so, the CMS editor is used to 
build a directory file with filename and filetype of ‘VNET DIRECTS. 
This file must reside on the VNET system disk when VNET is IPLed. As 
part of its initialization, VNET reads the directory and builds its 
system control blocks according to the local installation 
specifications. No installation variable information needs to be 
Specified with a VNET syster load. 


An installation may need to rake minor modifications to its VNET 
directory on a normal day to day basis. Installations might find it 
convenient to allow multiple write access to the VNET system disk for 
the purpose of updating the VNET directory (and the PROFILE VNET initial 
command file), taking precautions to avoid concurrent multiple access 
while writing the VNET system disk. EFecause VNET never writes its 
system disk, and reads its system disk only during execution of operator 
ccmmands, the directory may ke updated during production VNET operation, 
and tested by simply IPLing the VNET system disk in the virtual machine 
keing used for editing the updates. When this is done, the changes 
become effective on the next VNET vrirtual machine IPL. (Link and route 
definitions may normally Le made immediately effective by use of the 
VNET operator LCEFINE, DELETE, and ROUTE commands on the VNET operator 
console.) 


VNET maintains information pertaining to directly connectable locations 
in its link takle entries, and each indirectly connected location and 
its next direct link are identified in routing takle entries. The VNET 
link and routing tables are dynamically constructed during 
initialization, according to the directory specifications. In addition 
to the link and route definitions included in the VNET directory, VNET 
automatically generates sixteen null link entries and sixteen null route 
entries which may Le used tc dynamically define links and routes during 
VNET operation by means of the DEFINE and ROUTE commands. 


VNET will accept and enqueue a file for transmission if an empty tag 
slot is availakle; otherwise, the file is left pending, and cannot ke 
managed through the VNET command language. Pending files increase 
operating overhead and are awkward to deal with in general. The 
provision for pending files is intended to manage an abnormal situation 
age gracefully as possible, and installations should seek to avoid that 
operating circumstance. 


VNET builds its tag slots as part of its initialization. The number of 
tag slots built is at least as great as the sum of the tag slots 
reserved for exclusive use by links in the keep operands of the LINK 
directory control statements. More ‘extra' tag slots may be generated, 
up to a limit which depends on the size of the VNET virtual machine's 
virtual storage. This limit is computed as one tag slot per 1024 bytes 
of virtual storage. Extra tag slot generation may be requested Ly means 
of the TAGS directory control statement. The number of extra tag slots 
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requested on the TAGS statement is added to the sum of the links! 
reserved tag slots, up to the virtual storage limit. If no TAGS 
directory control statement is included in the directory, a default 
request of one extra tag slot per 2048 bytes of virtual storage is 
assumed. 


VNET DIRECTORY CONTROL STATEMENTS 


The VNET directory control statements should be in the following 
formats, with one cr more LElanks as operand delimiters. All operands 
are poSitional from left to right. If any operand is omitted, all 
operands to the right of that operand in the statement must he omitted 
as well. Operands may be entered in columns 1 through 71. All data 
entered to the right of column 71, and all data entered to the right of 
the last possikle operand are ignored. No continuation of VNET 
directory control statements is provided. Entirely Elank records, and 
records having an asterisk (*) in column 1 are ignored, allowing these 
lines to ke used for comments and print formatting. 


If a directory control statement is found to be in error during VNET 
initialization, the erroneous statement and a diagnostic error message 
are typed on the VNET operator console, the erroneous statement is 
ignored, and initialization processing continues. The directory control 
statements must ke grouped sequentially ky type when multiple statements 
of the same type are entered. Excluding comments and blank records, the 
first directory control statement must Ee a LOCAL statement, defining 
the local VNET installation's location IL. If links are to ke defined, 
all LINK statements must fcllow next. If default line driver 
initialization parameters are to be defined, all PARM statements must 
follow the LINK statements. If routes are to ke defined, all ROUTF 
statements must ke entered next. If allocatable switched 
telecommunications ports are to be included, all PORT statements must 
follow next. If extra file tag slots for enqueueing inactive files for 
transmissicn are to ke requested, a single TAGS control statement must 
ke entered next. 


Example: A simple VNET directory might appear as follows: 


* DEFINE VNET INSTAILATION VARIAFLES 


LOCAL VNETSYS 7 


LINK CAMEFRICG CMTVME Osu 5 

LINK TDCSYS1 DMTVMB 096 5 TDCI. * 8 
LINK WORKSTA1 DMTSML * 7 WS1 * bb 
PARM WORKSTA1 M1 

RCUTE PALOAITO CAMEBRITG 

ROUTE TOCSYS2 TDCSYS1 

ROUTE WCCSYS10 CAMERILCG 

ROUTE WCCSYS11 CAMBRIDGE 

PORT 086 

PORT 087 

TAGS 512 
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LOCAL Control Statement 


The LOCAL control statement is used to define the location identifier 
and time zcne of the local VNET installation. 


The LOCAL control statement must appear before all other control 
statements in the VNET directory, and it must appear exactly once. The 
format of the LOCAL control statement is: 


cr ia Ra a aL Ea aE aS | 

| r 1 | 

| LOCAL locid | zone | | 

| [| * | | 

| . : | 

t a eee a ee a ee ea a ee ee | 

where: 

locid is the one- to eight-character location identifier used to 
address the local VNET installation. This location identifier 
should be chosen to ke unique among all potentially 
interconnected locations. 

zone specifies the number of time zone boundaries between the local 


location and Greenwich to the east, the International Date 
Line being included as a time zone boundary. The zone number 
is used to convert local date and time to and from System/370 
time cf day format. Valid zone numbers range from decimal 
zero through 24. If zone is not specified, or is specified as 
*, a default value of zero (Greenwich Mean Time) is assumed. 


LINK Control Statement 


Fach LINK control statement defines the attributes of a single VNET 
link. Link attributes defined on a LINK control statement will apply to 
the link keing defined when it is activated, unless overriden by a START 
command parameter. 


The LINK control statement must immediately follow a LOCAL control 
statement cr another LINK control statement in the VNET directory. The 
format of the LINK control statement is: 


a avr Det te ial a wae ee Brey oN 
| ‘ ¢ . i Fr T C t VVUVVAA | 
| LINK linkid | driverid | port | zone | task | class | keep |[[J]II[ | 
| | * [ee PR a Ae 
| u t t c u t S4stt5 | 
ee eee ee ee a i eee ee ee er ce cre eS inh opens eas cumsguaninis reams 
where: 

linkid is the one- to eight-character link identifier for the link 


keing defined. 


driverid specifies the name of the line driver which is to be used for 
communication on the link keing defined. driverid is a one- 
to eight-character CMS file name of the TEXT file to be loaded 
and executed as the link's line driver program (e.g., DMTVMR, 
DMTVMC, DMTNJI, CMTSML, DMTNPT). The proper line driver 
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use with the link deprends on the type of remote 
telecommunications system involved. If driverid is not 
specified, or is specified as *, a default value of undefined 
is assumed, and the line driver type must ke specified when 
the link is activated. 


port specifies the virtual device address (hexadecimal CUU) of a 
permanent telecommunications port to be used for communication 
on the link being defined. Valid virtual device addresses are 
hexadecimal two through 6FF. If port is not specified, or is 
specified as *, a default value of undefined is assumed, and 
the port address must Le specified when the link is 
activated. 


zone Specifies the number of time zone koundaries between the 
link's remote locaticn and Greenwich to the east, the 
International Cate Line being included as a time zone 
boundary. The zcne number is used to convert System/370 time 
of day to date and time for use in messages to the remote 
location. Valid zone numkers range from decimal zero through 
24. If zone is not specified, or is specified as *, a default 
value of zero (Greenwich Mean Time) is assumed. 


task specifies a task name for use ky the line driver program 
associated with the link. Each VNET task must have a unique 
task name while it is active. Attempts to activate a link 
using a task name identical to the task name of a concurrently 
active task will fail with an error diagnostic message. Valid 
task names are one- to four-character alphameric characters. 
Task names reserved for VNET system control tasks are 'REX!, 
"AXS', and "LAX'. If task is not specified, or is specified 
as *, the task name definition defaults to the first four 
characters of the specified linkid. 


class specifies the classes of files which may be transmitted by the 
active link. Valid class specifications are one to four 
one-character VM/370 spool classes, which may be A through Z, 
0 through 9. Files will ke transmitted in class order, left 
to right. If class is not specified, or is specified as *, a 
default class of * is assumed, allowing files to be 
transmitted independently of class. 


keep specifies the numker of virtual storage file tag slots to be 
reserved for exclusive use Ey the link being defined. Valid 
keep specificaticns are decimal numbers from zero to sixteen. 
If keep is not specified, or is specified as *, a default keep 
specification of two is assumed. 


PARM Control Statement 


The PARM control statement defines a default parameter string of 
arbitrary text information to be made available to a line driver when a 
link is activated by means of a START command. The parameter string is 
generally used to specify processing modes or other options to a line 
driver, and its format and content are dependent on the type of line 
driver te be used. The parameter string specified in the PARM control 
statement may be overridden by the PARM parameter on the START command. 
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The PARM control statement must follow a LINK control statement or 
another PARM control statement. The PARM control statement must refer 
to a link which is defined by a previous LINK control statement, and 
only a single PARM control statement may ke included in the VNET 
directory for a particular link. The format of the PARM control 
statement is: 


a SS ee ONT Se OE Pe ee ee ee eG oN 
| PARM linkid [parmtext] | 
Oe cama ee ap ss ce eee Sep mas a as a a ee ee eee 
where: 

linkid is the one- to eight-character identifier of the previously 


defined link to which the parameter string is to apply. 


parmtext is any arbitrary character string, Founded by the leftmost and 
rightmost nonklank characters, which is to be interpreted as 
initialization information ky a line driver at link activation 
time. 


ROUTE Control Statement 


Fach ROUTE control statement defines a remote location with which the 
local VNET installation may indirectly exchange files, jobs, commands, 
and messages through one cr more interconnected locations. The ROUTE 
centrol statement specifies the location ID for a single remote location 
to be defined, and the link IL of the link on which transmissions 
destined for the remote lccation are to be made. 


The ROUTE control statement must follow a LINK or PARM control 
statement, or another ROUTE control statement. The link ID specified in 
the ROUTE control statement must have been defined in a preceding LINK 
control statement. The format of the ROUTE control statement is: 


a a a SR a a a Raa aS sD, | 

| ROUTE locid linkid | 

i a a eas em sa ee ee a ee ee ee ee 

wheres; 

lecid is the one~- to eight-character location identifier of the 
remote location which is being defined for indirect 
communication. 

linkid is the one- to eight-character link identifier of the link on 


which transmissions destined for the remote location which is 
being defined are to be made. This link must have been 
defined by a preceding LINK control statement. 
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PORT Control Statement 


Fach PORT control statement specifies a single switched BSC port that 
may be dynamically allocated for communication with a remote location at 
link activation time. Telecommunication ports may be defined for use 
with a particular link in a LINK control statement in the VNET 
directory, or as the object of a LINE keyword in a START command. If 
the port is not defined Ly either means, VNET will automatically search 
for an availakle switched port that has been defined by the PORT control 
statement in the VNET directory. If cne is found it will ke assigned to 
the newly activated link, and the operator will be notified of the 
assignment. 


A PORT control statement must follow the LOCAL control statement, and 
any LINK, PARM, or ROUTE control statement, or another PORT control 
Statement. The format of the PORT control statement is: 


c~ ane a ee es ee 
| PORT vaddr | 
a i es a a Sa a a a a ee ee ed 
where: 

vaddr specifies the virtual device address (hexadecimal CUU) of a 


Switched (dialakle) telecommrunications port that may be 
dynamically allocated for communication to a remote location 
to which no leased line connection exists. Valid virtual 
device addresses are hexadecimal 002 through 6FF. 


TAGS Control Statement 


The TAGS control statement allows the VNET installation to request extra 
tag slots to ke used to engueuve files for transmission. When VNET 
receives more files for transmission than can be enqueued in its 
available tag slots, the files are made pending. Pending files cannot 
ke managed through the VNET command language. 


The maxirun number of tag slots that can ke generated is computed as the 
size of the VNET virtual machine's virtual storage divided by decimal 
1024 (one tag slot per K of virtual storage). The sum of the tag slots 
specified to be kept in link definitions plus the number of extra tag 
slots requested in the TAGS control statement are generated at VNET 
initialization, up to the maximum number of tag slots described above. 
If the number of extra tag slots requested in the TAGS control statement 
exceeds the maximum number of tag slots described above, the maximum 
number of tag slots is generated and a diagnostic error message is 
issued. Otherwise, if the sum of the link keep specifications plus the 
request from the TAGS control statement exceeds the allowable maximum 
tag slots, the maximum numker of tag slots is generated and no 
diagnostic error message is issued. 
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The TAGS control statement must follow the LOCAL control statement, or a 
LINK, PARM, ROUTE, or PORT control statement. The TAGS control 
statement may be specified only once or omitted. The format of the TAGS 
control statement is: 


GS ae aa a a AS Ea | 
{| TAGS nnnnn | 
vr a TC ce a ee | 
where; 

nnnnn specifies the decimal requested number of extra tag slots to 


ke generated at VNET initialization time. This number 
represents the greatest number of files which may be 
concurrently engueved in addition to those enqueuved using tag 
Slots specified to ke kept in LINK control statements, 
assuming VNET virtual storage is sufficiently large to avoid 
truncation of tag slot generation. Valid requests for extra 
tag slots range from decimal 1 through 16384. A fixed length 
block of virtual Storage must ke reserved for each tag slot 
generated at VNET initialization. 


VNET DIRECTORY EXAMPLES 


This section illustrates rinimum VNET directory examples for three 
Simple networks. Each example presents the directory contents as viewed 
by each node in the network. These examples are designed to aid in the 
definition of your VNET system. 


Figure 5 shows the Simplest form of a job network consisting of two 
VM/370 systems connected via a teleprocessing line. This network 
contains two locations, NEWYORK and BUFFALO. The directory at location 
NEWYORK shows a LOCAL entry defining the location and the relative time 
zene of NEWYORK to Greenwich Mean Time (GMT). The LINK statement shows a 
direct communication path to location BUFFALO. This statement also 
defines the line driver type to ke used for communication with BUFFALO. 
Note that this must match the line driver type shown on the LINK NEWYORK 
defined at location BUFFALO. The directory at location BUFFALO reflects 
a mirror image of the directory at NEWYORK, showing a LOCAL entry of 
BUFFALO and a direct communication path (LINK) to NEWYORK. 


Figure 6 shows a three-node direct store and forward network consisting 
of three VM/370 VNET systems. These systems are interconnected via two 
telecommunications lines. Files destined for location MIAMI originating 
at CHICAGO must be stored and forwarded through location ATLANTA. The 
view of the network at location CHICAGO shows one direct communications 
path (LINK) to ATLANTA and one indirect communication path (ROUTE) to 
MIAMI through ATLANTA. The view of the network from ATLANTA shows direct 
paths (LINKS) to both CHICAGO and MIAMI thus no ROUTE statements are 
necessary. Finally location MIAMI shows a direct path to ATLANTA and an 
indirect path to CHICAGO through ATLANTA. 
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TWO NODE SIMPLE NETWORK 


New York Buffalo 


OO 


Local New York 5 Local Buffalo 5 


Link Buffalo DMTVMB 5 Link New York DMTVMB 5 


Figure 5. Two-Node Simple Network 


THREE NODE STORE AND FORWARD NETWORK 


; ; od) 
— gi 


Local Chicago 6 Local Atlanta 5 Local Miami 5 
Link Atlanta DMTVMB 5 Link Chicago DMTVMB 6 Link Atlanta DUTVMB 5 
Route Miami Atlanta Link Miami DMTVMB 5 Route Chicago Atlanta 


Figure 6. Three-Node Store And Forward Network 


The final example shows a four-node VM/370 network interconnected via 
three telecommunications lines and one channel to channel adapter. This 
illustrates the ability tc provide for alternate paths between two nodes 
in a VM/370 network. VNET provides for the definition of a direct path 
plus cne indirect path to a given location. However, caution must be 
used in specifying the network definitions when multiple paths exist. 
When using alternate paths, the indirect path should be specified only 
on one end of the network connection. 
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For example, assume the NEWYORK directory contains an alternate path 
(ROUTE) to BOSTON via TORONTO and the TORONTO directory contains a route 
to BOSTON via NEWYORK. If the direct links between NEWYORK/BOSTON and 
TCRONTO/ROSTON become inactive, a file destined for BOSTON would begin 
tc loop. It would be continually transmitted between NEWYORK and TORONTO 
until a link from either location to EOSTON became active. Therefore as 
shown in Figure 7, the indirect path (ROUTE) to BOSTON is specified only 
at NEWYORK. 


Similar examples could be shown for other paths in the sample network. 
Close coordination is necessary among the individual installations when 
defining a multi-system network. 


MULTI-NODE MESH CONNECTED NETWORK 


_ — 
Local New York 5 

Link Boston DMTVMB 5 

Link Toronto DMTVMB 5 

Route Boston Toronto 

Route North Toronto 


Local Boston 5 

Link New York DMTVMB 5 
Link Toronto DMTVMB 5 
Route Toronto New York 
Route North Toronto 


North 


Local Toronto 5 


Link Boston DMTVMB 5 
Link New York DMTVMB 5 ee 


Link North DMTVMC 5 
Route New York Boston 


Local North 5 

Link Toronto DMTVMC 5 
Route Boston Toronto 
Route New York Toronto 


Figure 7. Multi-Node Mesh Connected Network 
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LINE CRIVER SELECTION 


VNET provides the unique akility to manage many differing protocols 
among different links. FPecause of this flexibility the following 
guidelines are provided tec assist the user in choosing the line driver 
to use between two locations: 


e DMTNPT This line driver supports a 2770, 2780, 3770, or 3780 as a 
remote workstaticn to VNET. 


e DMTSML This line driver supports a MULTI-LEAVING remote workstation 
attached to VNET. These include 1130, S/3, S/360, S/370, 
and 360/Model 20 systems used as workstations. This line 
driver can also ke used to support the remote job entry of 
joks into batch systems nct supporting a job networking 
interface. 


e DMTVME This line driver supports VM/370 to VM/370 communications 
over binary synchronous communication lines. 


e DMTvMCc This line driver supforts VM/370 to VM/370 communications 
over a channel-to-channel adapter. 


e DMTNJI This line driver supports communications between VNET and 
Network Job Interface or Network Job Entry systems through 
binary synchronous communication lines or channel-to-channel 
adapter. These include HASP II Version 4.0, ASP 3.2, and 
JES2/NJE systers. 


NOTE: Two VNET systems can communicate using the DMTNJT 
line driver. This is not recommended as a regular method of 
communication kLetween VNET systems due to the protocol 
advantages inherent in the CDMTVMB and DMTVMC line drivers. 
This method of comrunication could be used as a test of the 
line driver and communications equipment prior to connection 
with an NJI or NJE batch system. 


In every case, the line driver used on a particular link must be 
compatible with the protocol used by the remote node. When the remote 
system is not another VM/37C VNET virtual machine, there will probatly 
ke only one line driver which may be used; DMTNJI, DMTSML or DMTNPT. 


ACCOUNTING INFORMATION 


DMTAXS text file is generated by the VNET Preloader using a loadlist 
named DMTAXS EXEC that contains two entries: 


&1 &2 DMTAXM 
&1 &2 DMTAXA 


DMTAXM is the main DMTAXS module, containing the body of the spool file 
manager. DMTAXA is the name of the accounting routine that produces 
accounting records for files handled by VNET. This routine may be 
modified or replaced on a local kasis to meet individual installation 
requirements. It is distributed as a default accounting routine with 
VNET. It uses the VM/370 diagnose x'4uc' to enter virtual user 
accounting records into the CP accounting card output. The format of the 
accounting record produced by the supplied DMTAXA is shown in Part 1 of 
this manual under Accounting Record Provision. 
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INSTALLATICN CONSIDERATIONS 


USE OF TWO-LEVEL REMOTE ALCCDRESSING 


The destination address structure in VNET allows for the use of a two 
level network address. This feature allows for a locally defined link 
to be addressed from other locations without having to be defined 
throughout the network. When a file is received at a destination VNET 
location, the userid parameter on the initial user TAG command is first 
checked against valid links defined at that location. If a matching 
link ID is found, the file is then routed to that locally defined link. 
If no link IC match is fcund, the file will be spooled to the specified 
virtual machine user ID. 


Note: If a user ID is identical to a link ID at its VNET location, any 
attempt to address a file to that user ID causes the file to be 
transmitted on the link and produced as real output at the directly 
connected remote station. 


INSTALLATICN REQUIREMENTS 


The update supplied with the installation tape for VNET for CP module 
DMKVSP must be applied to a VM/370 system for successful use of the 
VM-to-vVM line drivers, DMTVME and DMTVMC, in combination with the 
Network Job Interface line driver, DMINJI. 


This update allows for imbedding of application data to ke placed in the 
VM/370 spool system as a NOP (X'03') record. Current VM/370 discards 
the data associated with a NOP CCW. NOP records included in spool 
files, such as the current tag record, do not appear when spool files 
are read in virtual simulated readers or processed on real unit record 
output devices, but are accessible to programs using the CP diagnose 
read interface. 


VNET requires the facilities of VM/370 Rel 3. Also required are any 
telecommunications facilities needed to establish a transmission path 
between nodes. In addition to the VM/370 DASD and spooling facilities, 
approximately 30 cylinders of 3330-type direct access storage space is 
required. 
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INSTALLING VNET 


GENERAL INFORMATION 


The data and centrol files required to generate and install VNET are 
contained on the VNET distrikution tape. 


The distrikution tape contains the following CMS files: 


File 


VNET NUCLEUS 


VNET DIRECT 
PROFILE VNET 


DMTAXS TEXT 


DMTLAX TEXT 


DMTNJI TEXT 


CMTNPT TEXT 


CMTSML TEXT 
CMTVMB TEXT 
CMTVMC TEXT 


DMTLOAD EXEC 


DMTMAC MACLIB 


VNET CNTRL 


DMTxxx ASSEMBLE 


CMTMAC EXEC 


DMTAXS EXEC 


Contents 


The pre-assembled and generated nucleus supervisor 
routines required for VNET. 


A sample VNET directory. 
A sample profile command sequence. 


The preloaded spool file access method supervisor 
task. 


The communication line allocation supervisor task. 


The Network Job Interface (NJI) preloaded line driver 
module. 


The Nonprogranmable Terminal (NPT) line driver module. 


The Spocl MULTI-LEAVING (SML) line driver module. 


The VM-to-VM BSC (VMB) line driver module. 


The VM-to-VM CTCA (VMC) line driver module. 
The loadlist EXEC file. This file is required to 


generate an VNET nucleus on the VNET system disk. 


The file cortaining all the macros and copy files 
needed to assemble the VNET source files. 


The control file that is needed to assemble the VNET 
system via the VMFASM EXEC procedure. 


All the scurce files for VNET. There is an ASSEMBLE 
file for each TEXT file included in the loadlists 
(DMTLOAL EXEC, CMTNJI EXEC, and DMTAXS EXEC), and for 
each TEXT listed above, except for DMTNJI TEXT and 
DMTAXS TEXT which are generated by the preloader from 
the TEXT files included in the DMTNJI EXEC, and DMTAXS 
EXEC loadlists respectively. 


An EXEC file used to generate the DMTMAC MACLIB. 
The DMTAXS TEXT loadlist EXEC FILE. This file is 


reguired to preload the DMTAXS Spool Access Manager 
text file. 
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DMTNJI EXEC The DMTNJI TEXT loadlist EXEC FILE. This file is 
required to preload the DMTNJI line driver text file. 


XXXXXXxXxX MACRO 
XXXXXXxXx COPY Source files for the corresponding entries in the 
DMTMAC MACLIRB library. 


DEFINING YCUR WNET VIRTUAL MACHINE 


You need the VNET virtual machine defined when you generate VNET. This 
virtual machine must have at least 384K of virtual storage, a console, 
and a 5-cylinder VNET system disk with a write password. 


If you did not include an entry in your VM/370 directory for the VNET 
virtual machine, you must add one now. See "VM/370 Planning and System 
Generation Guide" for a description of the Directory program, including 
the control statements necessary to define a virtual machine. Add the 
newly coded control statements to the existing directory file, and 
asserkle and load the new VM/370 directory. 


A suggested VM/370 directory entry for an VNET virtual machine is: 


USER VNET password 512K 
ACCCUNT NUMEER EIN17 
OPTION ACCT 

IPL 191 

CONSOLE 009 3215 

SPOOL C 2540 READER A 
SPOOL D 2540 PUNCH A 
SPOOL E 1403 A 

LINK CMSSYS 190 190 R 
MDISK 191 3330 81 5 ULISK1 W password 
DEDICATE 078 078 
DEDICATE 079 079 
DEDICATE O7A OTA 
DEDICATE 570 570 


If the ACCT option is specified, VNET accounting records will be 
generated along with cther CP accounting card records. If VNET 
accountirg is not desired, it may be suppressed ky excluding the ACCT 
cption from the VNET virtual machine definition. If automatic IPL upon 
LOGON is not desired, the IPL directory control statement should he 
removed. If automatic IPI is desired and the VNET system disk is at an 
address other than 191, the IPL control statement should specify the 
virtual disk address which is to be used. 


VNET automatically adapts to any virtual storage size of 384K or 
greater. The larger the specified virtual storage, the greater the 
number of line drivers that may ke concurrently active, and the greater 
the number of default tag slots that will be automatically generated at 
VNET initialization. 


The ECMODE option is not required and not recommended for the VNET 
virtual machine. 
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GENERATION PROCEDURE FOR VNET 


Fefore you perform the generation procedure, be sure you have the 
following: 


e The VNET Distribution tape 
e A VM/370 directory entry for your VNET virtual machine 


e A VM/370 directory entry for the software system support virtual 
machine (for example, the MAINT entry supplied with the vM/370 
Starter system directory). 


You can use a 2314, 3330, 3340, or 3350 disk as the VNFET system disk. 
The VNET nucleus occupies two cylinders on a 2314 or 3340, and one 
cylinder on a 3330 or 3350 disk. 


The following system generaticn procedure for VNET assumes you have the 
MAINT virtual machine supplied with the VM/370 starter system in your 
VM/370 directory. 


If you wish to generate and run RSCS and VNET concurrently, care should 
be taken to isolate the installation and maintenance files of the two 
systems on two separate user disks. Module names, libraries, and update 
procedures are, for the most part, identical for the two systems. If 
the two systems! data areas are not kept separate, the results are 
unpredictacle. 


VNET is distrikuted on a reel of tape containing the necessary files. 
The first file contains the VMFPLC module in tape dump format. VMFPLC 
is used to load the final files of the tape. The exact contents of the 
tape are listed in the Program Directory which is shipped with each VNET 
system tape. The final files contain the following: 


e The files necessary to construct a default VNET System. This 
includes a VNET nucleus ready for installation on the VNET system 
disk, text decks for all line drivers, a sample VNET directory, and 
a sample PROFILE VNET initial operator command sequence, 


e DMTxxx files of filetyre ASSEMBLE containing the VNET source. 
e The COPY and MACRO files cortained in the DMTMAC maclib. 
e The DMTMAC maclib. 


e Required utility files for VNET: VNET CNTRL, DMTLOAD EXEC, DMTAXS 
EXEC, DMTNJI EXEC, CMTMAC EXEC, PRELOAD MOLCULE. 


e An update to mrodule DMKVSP in CP which is required for correct 
management of files which are to traverse any NJI link. 


Step 1. Logon as MAINT and IPL CMS: To build the VNET nucleus, you must 
logon the software system support virtual machine (MAINT) and IPL the 
CMS system. 


File 2 of the VNET distrikution tape contains all the files necessary to 
censtruct a standard VNET system. If you wish to install an unmodified 
VNET system, you may do so Ly simply loading this file onto the VNET 
system disk. No assembklies are required to install VNET unless local 
modifications are to be made. The remaining files on the distribution 
tape contain source and macros needed to assemble updated modules. The 
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instructions on the following rages describe the simplified installation 
procedure for an unmodified VNET system. Users wishing to include local 
modifications in their VNET systems may do so using this description and 
the following section entitled "VNET Maintenance." 


Step 2. Attach and Load tke VNET Tape: Mount the VNET tape, if it is not 
already mounted. Then you must attach the real tape drive to your CMS 
virtual machine (MAINT). For example: 


attach 280 to maint asc 181 


The VNET tape must Le at address 181 because the TAPE command ky default 
expects to find it at that address. 


With the 191 minidisk that belongs to MAINT accessed as your A-disk, 
rewind and load the tape: 


cp rewind 181 
tape load 


CMS responds with the following message: 


LOADING... 
VMFPLC MODULE A 
END-OF-FILE OR END-OF-TAPE 


disk and format it. If you used the suggested VM/370 directory entry 
for the VNET virtual machine, your LINK command is: 


link to vnet 191 as 195 w pass= password 


This makes the VNET system disk (address 191 in the VNET virtual 
machine) available at virtual address 195 in the MAINT virtual machine. 
Remember the address you specify for MAINT. You must use this same 
virtual address later in the VNET generation procedure. (You use 195 
when you Fuild the VNET nucleus in Step 7.) Then, format the VNET 
system disk. 


format 195 a 

Next, format the VNET system disk again. You must use the recompute 
function of the FORMAT command to make the last cylinders of the VNET 
System disk unavailable to the CMS file system. The last one or two 
cylinders contain the VNET nucleus. If the VNET system disk is a 2314 
or 3340, the last two cylinders are needed for the nucleus. For a 3330 
or 3350, only the last cylinder is needed. The FORMAT command for a 
2314 or 3340 VNET system disk is: 


format 195 a 3 (recomp 


The FORMAT command for a 3330 or 3350 VNET system disk is: 


format 195 a 4 (recomp 
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Step 4. Load the default VNET system: 


cp rew 181 
tape fsf 
vmfplc load 


Step 5. Modify the supplied VNET Directory: You can use the CMS Editor 
to modify the supplied VNET directory, 'VNET DIRECT’, to describe your 
local VNET configuration. The format of the entries in the VNET 
directory are described in a preceding section, "The VNET Dynamic 
Cirectory." 


The follcwing shows the sample directory which is supplied on the 
distribution tape: 


He RRC KK aK 2K fe 2 ok 2 2 fc 2k af af ofc 2K af af ake ae ak fe a fe ke ake af ae of 2 a ek ofc a oie of a oF ke 2k ai ok 2K 2K 2K a oi fe 2k ek ie i ic kK aK aK oe 2K ok 2 aK ok 


* 3K 
a ILOCAI LOCATION ENTRY = 
* mK 


He oe ok 2 2k 2K aK ok aK 2K fo ic a oe oie oe ak a ai aie kof a oe ake ok ak ak a ate ic ie 2 ok a ake i 2K 2k 2c a ic AC i Ko a ok a oie 2K aK aK aK oi 2c ic ok ik ie eo 2K aK 2c ok 


LOCAL HOME 


EPS SSS SSS SS SELL STS ES SS SSS STS TST STS SSS TSS ES SES SESS STS TST STE TS LS TS SESS SS 


* 3K 
* LINK CEFINITIONS m 
x X* 
ME OK 2K 2K 3k 2K 2k a ok 2 oe a 2K ok 2K ate ok oe oe ok ok ok oie a oi ae i ok fe 2h oe oe ea 2k 2K oe ok ok ae oe 2k 2 ae oe 2k ok 2K oe 2k oe ok a 2K a 2k ok aK ak 2 ok 2K aK ok 2k ok 
LINK NPTTEST DMINPT 
LINK SMLTEST CMTSML 
LINK NJITEST DMTNIT 
LINK VMETEST DMTVME 
LINK VMCTEST CMTVMC 


Step 6. Modify the supplied PROFILE VNET: The supplied PROFILE VNET 
initial startup command file may be modified using the CMS editor to 
automatically issue any sequence of VNET commands at VNET IPL time. 


Any legal VNET command may ke entered in the command sequence. The use 
of a dash (-) as the first character of a command line included in a 
VNET automatic executior file will suppress the printing on the VNET 
operator console of the CMTREX679I message, which includes the command 
line, as the ccmmand executes. This feature is interded to be used to 
Suppress printing of conment lines and of password information supplied 
in the parameter fields of START commands included in automatic 
execution VNET command sequences. 


The following shows the default PROFILE VNET supplied on the VNET 
distribution tape: 


SRR GO CO Oa io a ok i oiG Gi IG Gk ia GIG i kk ike kak i kkk a i ak ak ak aka ako ak akc ak ak 
* DEFAUIT CP COMMAND SETTINGS 

FICCI OR IO IC OR OR I GR I IO I OR I aC IO 3K ai ac kak ak 2k ak ok a aka aki ak a a ok 
CP SET IMSG OFF 

CP SET ENSG TEXT 

CP SPO CON START 
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nucleus rust now be placed in your virtual machine reader before it is 
written to the VNET system disk. The following sequence of ccmmands 
should ke used: 


CF CLOSE RDR 

CP PUR RDR ALL 

CP CLOSE PUN 

CP PUR PUNCH CL A 

CP SPO 00D TO * CL A 
PUN VNET NUCLEUS (NOH 
CP CLOSE RDR 

CP SFO 00D OFF 

CP IPL 00C CLEAR 


This final command will lcad the VNET nucleus. You receive the 
fcllowing messages: 


195 
yes 
003 (004 for a 3330 or 3350) 


DMTINI411R SYSTEM DISK ALCDRESS 
DMTINI412R REWRITE THE NUCLEUS 
DMTINI413R NUCLEUS CYL ALDRESS 


loew tl 


Your resfonses to the messages are shown to the right of the messages 
akove. You respond with the address of the VNET system disk, 195 in 
this case. You always regpond with the same address you specified as 
vaddr2 when you were ,prompted for link parameters. The nucleus cylinder 
address is the same number that you specified in the FORMAT 195 An 
(RECOMP) command in Step 3, and depends upon the device type of the VNET 
system disk in use. 


After a brief pause, you will have written an IPLakle VNET nucleus to 
the VNET system disk, as indicated by the message: 


DMTINI410I NUCLEUS WRITE COMPLETE 
CP ENTERED; DISABLFL WAIT PSW £00020000 00000012° 


You may now LOGON the VNET virtual machine, IPL the VNET system disk, 
and start your VNET operations. 


VNET MAT NTAINANCE 


Standard VM/370 maintenance procedures are used to maintain the VNET 
system. VMFASM can be invoked to assemble any VNET source module using 
the supplied VNET control file. Also, a Release 3 DMKMAC maclik must ke 
accessed for assembly of VNET modules. The loadlist DMTLOAD should be 
used when regenerating the VNET nucleus. 


The DMTNJI line driver is a multi-module line driver distributed with 
VNET. The VNET preloader is used to construct DMTNJI TEXT from its 
component modules, DMTNCM, DMTNHD, and DMTNIT, using the following 
command: 


PREIOAD DMTNJI VNET 
'DMTNJI* specifies the name of an EXEC file loadlist which includes 
entries for each module comprising the DMTNJI line driver. ‘'VNET! 


specifies the CNTRL control file to be used for specification of TEXT 
and TXTxxxx file selection priority. 
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The spool access manager CMTAXS is also a multi-module task. The VNET 
preloader is used to construct DMTAXS TEXT from its component modules 
DMTAXM and DMTAXA, using the following command: 


PRELOAD DMTAXS VNET 


'DMTAXS' specifies the name of an EXEC file loadlist which includes 
entries for each rodule ccrprising the spool access manager DMTAXS. 
'VNET' specifies the CNTRI control file to be used for specification of 
TEXT and TXTXXXX file selection priority. 


THE VNET PRELOALER 


The preloader is a VNET utility program that runs under CMS. The 
preloader collects multiple text files and reformats them into a single 
text file that can be dynamically loaded by the VNET loader. The 
preloader resolves external references and performs preliminary 
relocation of address constants. Its function is somewhat similar to 
that of existing link editors, except that its output is in standard 
text file format and does not include multiple CSECTs. Line drivers and 
other prcgrams to be loaded as VNET tasks may be developed as multiple 
separate assembly modules which externally reference one another, and 
the assemktled text files ray ke merged into a single VNET loadable text 
file by the preloader under CMS. The preloader is invoked as an 
ordinary CMS utility routine, using the following calling sequence: 


PRELOAD loadlist (control) 


'Ioadlist' specifies the filename of an EXEC file which must ke resident 
on the caller's A-disk. Fach record of this file contains the filename, 
and optional filetype, of a text (okject) file to be used as preloader 
input. ‘'Centrol' specifies the filename of a CNTRL file which must also 
ke resident on the caller's A-disk if it is specified. The format and 
interpretation of this file are the same as for the VM/370 VMFLOAD 
utility. If a load list entry includes a filetype, that filetype is 
used to identify the input file. Otherwise, if a control file is 
specified, input file identifiers are constructed using the filename 
from the load list entry and a filetype of the form 'TXT....' The 
highest ccntrol level identifier for which a file can be located on the 
caller's accessed disks is used. If no filetype is included in a load 
list entry and no control file is specified, a default filetype of 
'TEXT' is used. Input files are located by a scan of all the caller's 
disks in their access order. 


The preloader output consists of two files, one with a filetype of 
'"TEXT', the other of filetype "MAP", both with the same filename as that 
specified for the input load list. If either of these files already 
exists on the caller's A-disk, the old file is replaced Ey the new 
output file. 


The output TEXT file is the merged and linked copy of the input files. 
The first CSECT or private code section encountered in the input will 
become the composite (Single) output section, with a length which is the 
sum of all input section lengths (rounded up to doubleword multiples 
between sections as necessary fcr proper section alignment). For the 
output FSD, suksequent CSECTS are made into entries (LDs), and 
subsequent private code sections are disregarded. External references 
are included in the output ESD only if they remain unresolved. 
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Input TXT records of non-zero length are relocated and written to the 
output file. The output RID is an appropriately translated and 
relocated collection of all input RID records. The output END card does 
not specify any entry point, section length, or other code. No sorting 
is done ky the preloader. Ir general, each output ESD, TXT, and RLD 
entry appears in the same crder as the input entry from which it was 
translated. 


ACCON and VCON fields are relocated within their TXT records. The use 
of ORG statements which cause relocatable constant fields to overlay or 
to be overlaid will prckakly produce results that differ from results 
oktained with a lcader that completes TXT data loading prior to 
relocating ADCONs and VCONs. 


The output MAP file is a printable record of the preloader processing, 
Similar to a load map. The first line of the map specifies the output 
text file name, its residence volume lakel and virtual device address, 
and the date and time of file creation. The next section cf the map is 
a listing of the control file used, if one was specified. The remainder 
of the map consists of a sequence of input file sections, one for each 
input file in processing order. 


The first line of a map input section specifies the input file's 
filename, filetype, filemode, residence volume lakel and virtual device 
address, and the file creation date and time. (If the input file was 
lecated on a disk which was accessed as a ‘read-only A-disk extension', 
the filemode, volume label, and virtual device address of the A-disk 
will be listed.) If invalid records are encountered in the input file 
data, they are written in the map sequentially following the input file 
identification line. The VM/370 VMFASM utility enters such ‘invalid’ 
records in text files to specify the updates and macro libraries used in 
assembly. Following these records, the input file's ESD is listed, 
including control sectiors and entries with their relocated addresses, 
duplicate external symbols, and unresolved external references, if any. 
The first control section encountered in the input specifies the output 
control section name; the output section length is included on this ESD 
Map entry. 


The prelcader does not actually load its input modules into storage 
before generating its output section, but rather interprets, translates, 
and relocates its input text files on a two-pass record by record 

kasis. This approach requires that for each TXT record of a particular 
input control section, each RID entry (one for each ADCON and VCON) 
which lies within that control section must ke scanned to determine if 
it lies within the TXT record data. AS a result, the preloader 
processing time has a component which is proportional to both the total 
number of TXT records and the total number of RLD entries for each input 
control section. Roughly stated, this means that when a particular 
input control section grows sufficiently large, the time required to 
process it becomes proportional not to the input control section size, 
kut rather to the square of that size. This effect is likely to be most 
pronounced when a rather large text file which had been previously 
generated by the preloader is used as preloader input. In this case, 
much more CPU time may ke required to reprocess the preloader output 
than was required to generate it in the first place, because several 
smaller control sections have been merged into a single large control 
section. This kind of program behavior can he expected, and does not 
indicate any kind of malfunction. 


To speed preloader execution, relatively small (about 4K) input modules 
are recommended. Modules with unusually large numbers of relocatable 
constants should ke kept especially small, and module size is less 
important for modules with unusually small numbers of relocatable 
constants. 
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PART 3: VNET SYSTEM OPERATION 


Part 3 descrikes the operation of a VNET 
= System. The main areas included are: 


1. A general description of the 
operation of a VNET system. 


2. A description of the specific 
procedures needed to operate 
a VNET system. 


oN 
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OPERATION DESCRIPTION 


’ 


VNET OPERATOR COMMANDS 


EE EEE Cee 


The VNET operator controls the functioning of the local VNET facility. 
He can: 


e Manipulate the status, transmission priority, class and order of 
files owned Ly the VNET virtual machine. 


e Initialize, suspend, or terminate transmission of files to remote 
terminals and stations. 


e Reposition or restart files currently being transmitted. 


e Send mressages to remote terminals, stations and other nodes in the 
network. 


e Send commands to remote batch processing systems. 
e Query file, link or system information. 
e Monitor link activity for any directly connected remote location. 


File attributes and the parameters describing them in the VNET command 
language have maximum and default values identical to those of the 
VM/370 command language. Eecause many of the VNET operator commands are 
available to remote station cperators, only Erief descriptions of the 
commands that apply to the VNET virtual machine are included in this 
section. The commands are grouped in a general chronological sequence 
as the operator would use them. A complete description of all commands, 
with detailed format, can ke found in “Appendix A: VNET Commands". 


The commands available to the VNET virtual machine operator fall into 
fecur general classifications: link and line control, file ccntrol, 
communication and miscellaneous. 


LINK AND LINE CONTROL COMMANECS 


There are nine commands available to the VNET operator to manage the 
links and lines used for file transmission: CFFINE, ROUTE, DELETE, 
START, DRAIN, FORCE, HOLD, FREE, and SHUTDOWN. 


The DEFINE Command 


Use the CEFINE command to temporarily add a new link entry to the list 
of valid links (link table) for the local VNET installation, or to 
temporarily redefine an existing link definition. (Permanent link 
definitions or redefinitions can only be made by modifying the VNET 
Directory.) A link definition, with a link identifier equal to the 
lecation identifier cf a remote station, must exist in the VNET link 
takle before any transmission of files, to or from that remote station, 
can occur. 
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The DELETE Command 


Use the CELETE command to temporarily delete a link definition from the 
VNET link takle. (Permanert link deletions can only be made by deletion 
from the VNET Virectory.) The link to ke deleted must be inactive 
(drained or not started), and must have no unprocessed files addressed 
to it. Files subsequently addressed to a deleted or undefined link are 
purged from the system. 


The ROUTE Command 


Use the ROUTE command to define, modify, or delete an entry in the VNET 
routing table. Files are automatically reenqueuved following execution of 
a route command, so that trarsmission of rerouted files can begin 
immediately. 


The START Command 


Use the START command to activate a particular inactive link. Certain 
keyword options may also Le entered to temporarily override the link 
definition in the link takle. This ccmmand may be issued to an active 
link but sclely for the purpcse of altering the class of files to ke 
processed on that link or to reset a DRAIN operation before it has 
completed. 


The DRAIN Command 


Use the DRAIN command to deactivate an active link. If the link is 
currently processing a file, the link is deactivated when the current 
file has completed processing. If no file is being processed, the link 
is deactivated immediately. 


The FORCE Command 


Use the FORCE command if the DRAIN command fails to deactivate a link. 
The FORCE command causes immediate deactivation of the specified link 
and termination of its line driver task regardless of the status of file 
processing. 


The HOLD Command 


Use the HOLD ccmmand to temporarily suspend file transmission on an 
active link without deactivating it. Transmission is suspended at the 
end of the file currently Leing processed unless a keyword is entered 
Ssignifyirg that transmission is to ke halted immediately. In either 
case, transmission is restarted at the interrupted point when the FREE 
command is issued. 


The FREE Command 


Use the FREE command to resume transmission on a link previously in HOLD 
status. 
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The SHUTDOWN Command 


Use the SHUTDOWN command fer normal termination of VNET operations. 
SHUTDOWN effectively issues a DRAIN ccmmand to each currently active 
link. 


FILE CONTROL CCMMANDS 


Files that are sent to the VNET virtual machine for transmission are put 
into the file queue assigned to the particular link to which the file is 
addressed. The VNET operator can use four commands to control these 
files while they are waiting to ke transmitted: CHANGE, ORDER, REORCER, 
TRANSFER, and PURGF. These are defined as inactive files. He can also 
use four other commands to control files that are currently being 
transmitted: FLUSH, CLOSE, BACKSPAC, and FWDSPACE. These are defined as 
active files. 


Tke CHANGE Command 


Use the CHANGE command to alter one or more file attributes of a file 
owned by the VNET virtual machine, engueved on some link's file queue, 
and not currently active. 


The ORDER Command 


Use the CRCDER command to reorder the files enqueued on some link's file 
queue. This redefines the order in which particular files are 
processed. A file currently keing processed cannot ke reordered. 


The REORDER Command 


Use the REORDER command to cause all inactive files controlled by VNET 
to ke reaccepted and routed. It is normally not used by the VNET 
orerator but by VNET during internal operations. See command 
descriptions for details of REORLCER usage. 


The TRANSFER Command 


Use the TRANSFER command to redirect specified inactive files enqueued 
ona link to a new destination. This causes VNET to dequeue them from 
the specified link and enqueve them on the link associated with the new 
specified destination. 


The PURGE Command 


Use the PURGE command to remove all or specified files, enqueued on a 
link, from the system before they are processed. A file currently being 
processed cannot be purged. 
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The FLUSH Command 


Use tke FLUSH ccmmand to discortinue processing the current file ona 
specified link. The discontinued file is either purged or held and link 
processing continues with the next file enqueued for transmission on 
that link. If the COPY attrikute for the file specified multiple copies, 
only that current copy is discontinued unless the discontinuance of all 
copies for the file is also specified. 


The CLOSE Command 


Use the CLOSE ccmmand to clear the files if a link unexpectedly becomes 
inactive while processing active files. Active input files are 
reenqueued as inactive and later retransmission begins at the start of 
each input file. Active output files are purged. 


The BACKSPAC Command 


Use the PACKSPAC command to restart or reposition, ina backward 
direction, the file currently Lteing processed on the specified link. 


The FWDSPACE Command 


Use the FWDSPACE command to reposition, in a forward direction, the file 
currently keing processed on the specified link. 


COMMUNICATION CCMMANDS 


The VNET operator can communicate with a remote station via the CMD or 
MSG commands. The choice cf command used depends on the interpretation 
tc be given to the text portion of the command. 


The CMD Command 


Use the CMD cormand to control functions performed by a remote system 
such as a HASP or ASP type k-atch processor, a remote VNET system, or a 
remote NJI compratikle syster. 


The text portion is interpreted as a remote system command and is made 
available to the line driver for the next transmission. The functional 
meaning of the text depends on the nature of the remote system that 
receives the command. For exarple, if the remote system is a HASP or 
ASP type processor, the text would be: 

$ Hasp cmd 

* Asp cmd 


For information on the allowakle commands, refer to the appropriate 
subsystem system manuals listed in the Preface. 
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Use the MSG command to send a message (aS opposed to a command) to a 
remote station operator, remote VNET system operator, remote NJI system 
operator, or remote virtual machine user. The text portion is made 
available to the line driver for the specified link. 


MISCELLANEOUS COMMANCS 


Seven other commands are available to the VNET system programmer and 
operator to monitor and control the local network. They are: 


The * (comrent) Command 


Use the * command to place comments or notations on the VNET operator 
console listing. It is accepted Fy the command processor but performs no 
function. 


The CP Command 


Use the CP Command to pass any permitted commands to the VM/370 Control 
Program without leaving the VNET environment. 


The DISCCNN Command 


The CISCONN command is used Ey the VNET operator to disconnect his 
console from the VM/370 system while VNET continues to operate. An 
cpticnal userid may be entered in the command line to specify the 
virtual machine that is to receive all VNET operator console output 
lines. If no virtual machine is specified, the VNET console output 
lines are discarded without being printed. 


The EFXEFC Command 


Use the EXEC command to execute frequently used sequences of VNET 
ccmmands. The commands are stored in a CMS file on the VNET system disk 
with a file type of VNET. 


The HT Command 


Use the HT command to Suppress the printing of any unwanted messages 
that are stacked for output to the VNET operator's console. 


The QUERY Command 


The QUERY command is used to request VNET system status information to 
be printed on the VNET operator console or remote station printer. The 
information requested can ke for a particular link, a specific file, or 
for the system in general. 
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LINK INFORMATION: For a particular link, the operator can request 
status, activity, default,file,or queue information. 


Status information includes activity status, type of line driver, line 
address, classes of files to be processed, HOLD status, DRAIN status, 
TRACE status, number of files in queue and number of files waiting to be 
queued. 


Activity information includes the VM/370 spool file ID, originating 
VM/370 spool file ID, destination location and user ID, spool file 
class, file trarsmission priority, number of file records left to 
transmit, and total records, of the file currently being transmitted. 


Default information includes task name, type of line driver, line 
address, classes of files to be processed, time zone identifying digit, 
and number of virtual storage file tag slots reserved for the specified 
link. 


File inforration includes the number of files being transmitted, the 
number of files being received, the number of files accepted and in the 
queue, and the number of files pending. 


Queue information includes the number of files in the queue and the 
number waiting to be entered in gueue. In addition, for each file 
currently in the queue, an additional response is issued containing the 
spool file identification number, origin location, destination location, 
destination user ID (if any), spool file class, current transmission 
priority, the number of records in the file, and the file hold status. 


FILE INFCRMATION: For a specific file, the operator can request status 


information, VNET-related file attributes, or VM/370 spool-related 
attributes. 


Status information includes activity status and the linkid of the link 
on which the file is queued or being transmitted. 


VNET-related attributes include originating location and user ID, 
Originating VM/370 spool IL, date and time of creation, time zone 
reference for time of day and the destination location and user ID. 


VM/370 spool-related attrikutes include transmission priority, spool 
file class, number of copies requested, HOLD status, distribution code, 
filename and type, and data set name. 


SYSTEM INFORMATION: The VNET operator can request a btrief description of 
each inactive link, active link, port, non-zero queue, or route 
currently defined in the system. 


Inactive link information includes link identification, activity status, 
default line driver type, and default line address. 


Active link information includes link identification, link status, line 
driver type, line address, and held status, drain status, and trace 
status. 


Port information includes port availakility status and identification of 
ports in use Ey link ID and fort address. 


Queue information includes the number of files being transmitted and 
received, the files accerted and enqueued, and the files pending for 
each link ID with a non-zero queue. 


Route descriptions show the link ID for each route definition in the 
system route table. 
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re TRACE Command 


Use the TRACE command to monitor line activity on a specified link. The 
trace information message includes the total number of communication 
line transactions (write/read combinations), the number of communication 
line transactions ending with a line error indication, and the number of 
timeouts that cccurred on the line. 


The line activity indicators are constantly accumulated by an active 
line driver, however the printing of the results on the VNET operator's 
console is initiated only through the TRACE command. 


Note that the TRACE command results in the printing of summary 
information akout a link at the VNET operator's console. The TRACE 
ccmmand with the LOG operand results in the creation of a printer spool 
file containing a detailed log of every I/O transaction on a link. 


NET MESSAGES 


cee ee ee 


VNET messages are issued in response to commands, and during system 
execution. The response message is delivered to the associated command 
Originator, generally the VNET local or remote operator, or both, 
depending on the availability of the remote station printer to serve as 
an operator console output medium. When VNET is operating 
"disconnected", unsolicited messages are issued to another virtual 
machine console or to the VM/370 operator console Ey means of the VM/370 
MESSAGE command, if it is so specified in the DISCONN command. Console 
spooling can also be used to record messages issued to the VNET 
oferator's console when the VNET virtual machine is running in 
disconnected mode. If these options are not taken, these messages are 
discarded. 


Certain unsolicited messages are issued to virtual machine users via the 
VM/370 MESSAGE command wken the message pertains to a file originated by 
or destined for the user. 


A listing of all VNET messages, unsolicited or in response to commands, 
can be fourd in “Appendix E. VNET Message Summary." For a detailed 
listing and descripticn of all VNET messages, see "Appendix B: VNET 
Messages", 


The message codes listed ccenform to VM/370 standards. The origin of each 
message is encoded as the fourth, fifth, and sixth character of each 
message code. The possikle codes are REX, CMX, AXM, INI, RGX, IRX, and 
Xxx, where xxx is replaced with the code of the particular line driver 
module which is issuing the message: NPT, SML, VMB, VMC, or NCM, NUD, 
and NIT for the NJI driver. Printing of the ten-character message codes 
may be suppressed by the local and rerote VNET operator by use of the 
SET EMSG ccmmand. 


VNET utilizes the Diagnose function of CP to handle console functions 
such as CEFINE and DETACH. The use of these VM/370 commands by VNET 
results in two confirming messages being printed on the operator's 
console for each file processed by VNET. The VNET operator can issue 
the CP ccmmrand SET IMSG OFF to suppress these informational messages. 


In the event of a fatal error, VNET enters a disabled wait state. If 
either the CMTREXO90T or CMTREX091T message is displayed on the VNET 

orerator's console, an autcmatic virtual storage dump is also taken. 

Otherwise, the CP DUMP command should be issued. 
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CCMMUNICATING WITH JES2 NJE SYSTEMS 


VNET supports a subset of the full NJE protocol defined by the Network J 
Job Entry Facility for JES2. For details of the full NJE protocol refer 

to Logic: Network Job Entry For JES2, Order No. LY24-6001. The 

following points must ke considered when communicating with a JFS2 NJE 

system: 


1. The DMTNJI line driver supports the predefined connection protocol 
used by JES2 NJE. Therefore, any connection between VNET and JES2 
NJE wust be predefined Ly the JES2 system using a ‘CONNECT! 
statement in the JES2 initialization deck. Failing to include the 
"CONNECT' statement produces unpredictable results at link 
connection time. Additional 'CONNECT’ statements must be added to 
the JES2 initialization deck for any locations receiving files 
from JES2 through the predefined VNET connection. 


2. The DMTNJI line driver uses a single transmission stream (either ed 
job or output) to a remote system. It supports the simultaneovs 
reception of one job stream and one output stream. 


3. When a data set with multiple destinations is received by DMTNJI, 
the data set is stored and forwarded by VNET as separate files. 
When a job output file containing data sets with different 
attributes is processed ky VNET (such as an output file containing 
both print and punch data sets), it is stored and forwarded as 
separate files. 


GY. NJE Glokal commands not destined for the local node are stored and 
forwarded to the final destination system in the normal manner. 
Global commands directed to the local VNET system by DMTNJI are 
translated into the appropriate VNET command. If the final 
transmission link to the local VNET system is not through the J 
DMTNJI line driver, Global commands are not processed by VNET. 


IC CARD FORMAT FROM REMOTE STATIONS 


The ID card is entered at the keginning of a deck of cards from a remote 
terminal to specify the network destination of the file being entered. 


The format of a single parameter ID card is as follows: 


Ic userid 
| 
1 10 


‘userid’ specifies the destination user at the directly connected VNET 
location to which the file fcllowing the ID card is addressed. 


The format of the two paramter ID card is as follows: ’ 
TC locid userid 

| | 

1 10 


"locid' ‘userid' specifies the destination location and user address to 
which the file following the ID card is addressed. ‘userid’ may be , 
replaced ky the keyword ‘SYSTEM! if the file is to be produced as real 
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unit record output at the destination location, and ky the keyword 'JOB 


if the file is to be e 
processing system via 


ntered as a job at the destination batch 
the Network Jok Interface (NJI). 


HEADER CARC FORMATS FOR VM/370 REAL READER 


Files or jobs may be s 
VNET for transmission. 
by an ID card to direc 
card to specify destin 


QQ 


| 
| ID ‘userid’ 
| 


where; 

ID is ama 

userid Specifi 

CLASS is an o 

n specifi 
0-9. Th 

filenare specifi 

dsname 

filetype specifi 


The punching must st 
be separated kLy a El 


The second card contains the 'tagtext' portion of the TAG command used 


when submitting a file 


'tagtext ! 


a 
| 


Punching starts in 

by a blank column. 
A sample job file subm 
transmission to the no 


ID VNET 
HCUSTON JOB 
/ A XXXXXXXXXX 


//XXXXXXXXXX 
/ f/f RRRRXXXXXX 


ubmitted through the VM/370 real card reader to 


The data deck to be transmitted must be preceded 


t it to the VNET virtual machine and a 'tagtext' 
ation. The format of these cards is as follows: 


oe ee 


CLASS n 'filename' 'filetype' | 
'dsname' 


ndatory keyword. 
es the name of the VNET virtual machine. 
ptional keyword. 


es the file class. The options are A-Z, 
e default is A. 


es the label on the input data. 


es the type of file if 'filename' is used. 
art in card column one and each field must 


ank column. 


from a virtual machine user console. 


card cclumn one and all fields are separated 


itted through the real card reader to VNET for 
de HOUSTON is shown below. 


First card (ID card) 
Second card (tagtext card) 
Job file to ke 


transmitted to HOUSTON 
ky VNET. 
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OPERATION PROCELURES 


SYSTEM START-UP 


Under normal operating cecnditions starting VNET requires no operator 
action after the VNET virtual machine IPI. The route and link tables 
are created during the system initialization from the VNET directory on 
the VNET System disk. The line drivers are normally started by the 
automatic execution of the *PROFILE VNET! file. All required START 
commands for the line drivers to be used are placed in the ' PROFILE 
VNET! file by the system programmer at system generation time. 


Additional line drivers may Le started individually, if required, by 
uSing the START command formats Shown in the descriptions of starting 
the various line driver types. 


Any temporary changes desired in the link and route definitions can be 
made uSing the commands descriked under "Dynamic Reconfiguration", 


SYSTEM SHUT-DOWN 


Operation of the VNET virtual machine is terminated when the system 
operator issues the SHUTCOWN command. This effectively issues a DRAIN 
cemmand to each active link. Any link that is currently processing a 
file will complete that file and then deactivate. A link that is not 
processing a file deactivates immediately. When all links have reported 
successful deactivation the VNET operator may logoff his VNET virtual 
machine. 


Any files waiting for transmission at the time of system shutdown will 
be retained by the VM/370 spooling facility. These files will be 
reaccepted and enqueued to the appropriate links when the VNET virtual 
machine is started again. 


STARTING LINE CRIVERS 


Line drivers manage the transmission of files between the VNET virtual 
machine and a particular class of remote nodes, terminals or stations. 
Five line drivers are supplied with VNET, designated as DMTNPT, DMTSML, 
CMTVMB, CMIVMC, and DMTNJI. See the section on "Line Drivers" in "Part 
1: Introduction" for a detailed description of the function of each line 
driver. 


The VNET operator initiates a line driver for a particular link by 
issuing the START command. If the previously defined link definition is 
still valid, only 

START linkid 
need be specified. Should any of the link attributes require 


modification for this particular communication session, the START 
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command with appropriate operands is used. For example, if the link to 
HOUSTON had been defined with a line address of OB1 and a class of G, 
and the current session is to handle class S output on line address OB3, 
the START command would look like: 


START HOUSTON CLASS S LINE OB3 


For this session only, the HOUSTON link processes only class S output 
and uses the line port with virtual address 0B3. Non-class S ottput 
remains gueued on Houston's link and is not transmitted until the class 
attribute is changed. 


Since more than one link can require the same line driver, multiple 
copies of a line driver can ke active simultaneously. Each copy is 
assigned a task name at the time the link is defined; otherwise, an 
appropriate descriptive default task name is generated by VNET when the 
link is activated. 


Orce the line driver is activated during system start-up or by the VNET 
operator, the link for a leased line is ready for a remote station to 
"sign on" with its identification and station characteristics. A link 
using a switched line must first complete a line connection by a dial-up 
procedure from either end of the link. The sign-cn procedure varies by 
line driver and is covered in the respective line driver discussions. 


STARTING SML 


Refore a remote station can sign on to SML, the appropriate task for 
that link must have been started during system start-up or by the VNET 
operator. An example of the START command for SMI and the variables to 
be specified is as follows: 


i a EEE a a REE SR, | 

| STArt { linkid{ TYPE DMTISMI ][ LINE vaddr]| 

| | {Hrn} | 

| | {Rrn} r 1 | 

| | Parm {Arn}[Bnnnn]| password] | 

| | {Mrn} |user/pwd| | 

| | : 4 | 

t a ae an ee es | 

where: 

linkid is the location identifier of the remote station that is to 
communicate with SML. 

CMTSML is the name of the line driver to be used with the newly 
activated link. This specification overrides the driver name 
which may have keen previously defined for the link. If no 
driver was previously defined for the link, this field must ke 
specified. 

vaddr is the virtual address of the communications line. (vaddr is 
used only if the line is to be other than one previously 
specified ina link definition.) 

Hrn sets SML mode, indicating that SML operates as a remote job 


entry system into a remote HASP or JES2 system as remote 
number rn. 
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Rrn sets SML mode, indicating that SML operates as a remote job 
entry station into the Remote Entry Suksystem (RES) of VS1 
Release 2 as remrote number rn. 


Arn sets SML mode, indicating that SML operates as a remote job 
entry system into a remote ASP or JES3 system aS remote name 
rn. 

Mrn sets SML mode, indicating that SML operates as host toa 


remote programmakle station Signing on as remote number rn. 


Bnnnn indicates the telecomrmunication buffer size. The maximum value 
that can be specified in nnnn is 1017. If. the operand is 
omitted, the buffer size defaults to 400. If the optional 
password operand is specified, the buffer size must be 
entered. 


password is an optional cperand, used by the DMTSML line driver to 
user/pwd validate the start of a terminal session as follows: 


e In RJE mode, the specified identification is passed along 
to the remote system as part of the SIGNON record. 


If the remote system is HASP, ASP, or JES, identification 
consists of a cne- to eight-character password. 


If the remote system is RES, identification consists of a 
one- to eight-character userid followed by a slash 
character followed ky a one~- to eight-character password 
for a maximum of 17 characters. 


e.In HOST mode, the identification consists of a one- to 
eight-character password that the remote station must 
supply on its SIGNON card in order to connect to VNET. If 
no password is entered on the START command, none will be 
required frem the remote station. 


For a full description of the START command, refer to "Appendix A: VNET 
Ccmmands", 


If the operator has initialized the appropriate SML task, contact may ke 
established by dialing the other location from either end of the link. 
If the line specified is a leased line, or if the above contact 
procedure has keen successfully accomplished, the sign-on procedure is 
then executed. 


Signing On in RJE Mode 


If SML is operating in RJE mode, the SML task signs on to the remote 
HASP/ASP system. Using information from the START command and standard 
HASP/ASP protocol, SMI builds a SIGNON record and sukmits it to the 
remote system. When the remote system accepts the SIGNON record, SMI is 
notified and communicaticn on the link is initiated. 


Signing Cn in HOST Mode 


If SML is operating in HOST mode, the remote station must submit the 
Sign-on information. Since remote programmable stations are loaded with 
Remote Terminal Processor (RTP) programs in order to communicate with 
VNET, the SML SIGNON card or its equivalent is included in the program 
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deck. A password for system security nay also be included. The format 
of the SIGNON card is as follows: 


1 16 25 2 


/*SIGNON REMOTErn password 


The value of rn following the keyword REMOTE must match the terminal 
number specified in the Mrn oferand of the START command. 


A password is required only if the START command specified a password 
operand, or if a password was part of the link definition in the VNET 
link table. If the password option is in effect, the password entered 
must match that in the START ccmmand or link table for the sign-on 
procedure to be completed. 


File Processing (RJE Mode) 


SML, operating in RJE mode, transmits files consisting of job control 
records and data to remote MULTI-LEAVING batch systems such as HASP and 
ASP. These files can originate from: 


e  VM/370 users spooling the files to VNET. 


e Remote terminals sukmitting card decks, through an NPT line driver 
with valid destination information in the ID card. 


e Remote stations submitting card decks, through an SML line driver 
operating in HOST mode, with valid destination information in the ID 


card. h 


e Remote NJI/NJE systems sukmitting card decks. 


When the remote batch system has completed processing the data, printer 
and/for punch output is transmitted btack to SML. This output is then 
printed or punched on the appropriate real I/O device at the directly 
cennected location. 


Input File Processing (HOST Mode) 


The remote station submits input to the VNET machine through the remote 
card reader. This input can ke directed to the virtual reader of a 
vVM/370 user or to another remote terminal or location. Output 
processing at the remote station can usually be interrupted at any point 
to allow the transmission of input data. The specific procedure for 
interrupting outfut processing varies according to the remote hardware 
keing utilized; this is explained in the "Operating Procedures" for the 
specific remote station. When the input has been processed, output 
processing can ke resumed from the point of interruption. 


A control card is placed in front of the deck to ke sent from the remote 

station to the virtual machine card reader of a user or to another node, 

remote terminal or station. The format of this card is described under 

"ID Card Format from Remote Stations" in the "Operation Description" ; 
section. If the remote system console is used to enter the ID data, S) 
upper case notation must be used. 
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Output File Processing (HOST Mode) 


When printer and punch files are transmitted to a remote terminal, a 
header line is created on the output to identify the originating userid, 
date, and time of transmission. Card decks punched at the remote 
terminal contain the source header information on the first card 
punched; the rest of the card is filled with asterisks. Printer files 
use a carriage control tape with channel 1 Signifying the first print 
line. 


In addition to header informwation, printer files are separated from one 
another ky header pages which may be seen by the operator, at the edge 
of the unburst paper, to allow the operator to separate printed output. 
The header page format is as follows: 


- page eject 

- skip 61 lines 

- 5 lines of n asterisks per line 
- 1 line of n underscores 

- 5 lines of n asterisks per line 
- 2 blank lines 

- the source header line 

- page eject 

- the print file 


where n is 120 or the numker of printable positions available on the 
remote printer, whichever is less. 


The card and print file header information is as follows: 


Col Field Meaning 
1 11111111 file origin location 
13 vnvirvmvm file origin virtual 
machine 
25 XX/XX/XX file origin date 
37 yy: yy:yy file origin time 
uy XeoXet. time zone 
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Remote Station Operator Commands 


The remote station operator, under control of SML in HOST mode, is 
allowed to use a subset of the VNET commands. In general, the remote 
operator can issue commands that affect only his specific link. The 
VNET commands are descrited in "VNET Operator Commands", A complete 
description of all commands, with detailed format, can be found in 
"Appendix A: VNET Commands". 


Note: With the exception of the MSG and CMD commands, the linkid 
operand is not to ke entered by a remote station operator when 
submitting commands to VNET. 


SML Messages 


A subset of VNET operator messages are printed on the remote station 
console. Generally, they are responses to commands originating at the 
remote Station. For a key to the distribution of messages, see "Appendix 
B: VNET Message Summary". 
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STARTING NPT 


Before a remote terminal can Sign on to NPT, the appropriate task for 
that link must have been started during system start-up or by the VNET 
operator. An example of the START command for NPT and the variables to 
be specified is as follows: 


a reg Le ee ee ap ge a ee, BoE Te Ae op tke age ere ee ne ee 

| STArt [| linkid{ TYPE DMTNPTJ[LINE vaddr ]| 

| | [{Parm password[ | 

| | 

' Pn ee ee ae | 

where: 

linkid is the location identifier of the remote terminal that NPT is 


to communicate with. 


CMINPT is the name of the line driver to be used with the newly 
activated link. This specification overrides the driver name 
that may have been previously defined for the link. If no 
driver was previously defined for the link, this field must be 
specified. 


vaddr is the virtual address of the communications line. (vaddr is 
used only if the line is to be other than one previously 
specified in the link definition.) 


passwd is an optional operand of one to eight characters which, if 
entered, designates a password that the remote station must 
supply to ke allowed to connect to the VNET system. If a 
password is not supplied in the START command or in the VNET 
link table, the remote station is not required to supply a 
password at sSign-cn time. 


For a full description of the START command, refer to "Appendix A: VNET 
Ccmmands", 


Signing On to NPT 


Once the operator has initialized the appropriate NPT task, contact may 
be established on a switched line by dialing the other location from 
either end of the link. If the line specified is a leased line, or if 
the above contact procedure has been successfully accomplished, a SIGNON 
card must then be entered via the card reader at the remote terminal. 
The SIGNON card must precede all other cards, and is used only once in 
each session. In the event of a line drop, the SIGNON card must be 
re-entered via the card reader in order to restart the line. The SIGNON 
card is used to designate the type of terminal, the features it has, and 
other information as descriked below. 


aa a a aa iS ie a aren a a ae tee 
| SIGNON | linkid type[Bnnn][CMPR][ Pnnn] | 
| | [{TRSx][PCHx][ PWD= passwd] | 
ie ec a en er enon as a See _ nena | 
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wheres: 


Linkid 


type 


Bnnn 


CMPR 


Pnnn 


IRSx 


PCHx 


LPRT 


is the location identifier of the remote terminal signing on 
to NPT. If this does not match the NPT task linkid of the 
START command, the SIGNON card is not accepted. 


indicates the terminal type and must be 2770, 2780, 3770 or 
3780. 


specifies the line kuffer extension in terms of the number of 
bytes (nnn) and may be: 128, 256, or 512 for the 2770; 17¢ or 
400 for the 2780; 256 for the 3770; and 512 for the 3780. The 
defaults are: 


Terminal Default 


2770 128 
2780 170 
3770 256 
3780 a2 


specifies that the -lank compression feature is present on the 
2770, 3770, and 3780. 


specifies the number of print positions available at the 
remote printer. nnn may be 120, 132 or 144. The default 
value is P120 for the 2770, 2780 and 3780; it is P132 for the 
3770. 


is entered as TRSY (YES) if the remote terminal has the 
transparency feature and TRSN (NO) if it does not have the 
transparency feature. The default is TRSN. 


is entered as PCHY (YES) if a punch is available at the remote 
terminal and PCHN (NO) if no punch is availakle. The default 
is PCHN. 


specifies that all print output, including messages, is to ke 
directed to the line printer. This keyword is only valid when 
a terminal type of 3770 has been specified. If the keyword is 
omitted, the default print device is the console printer. 


PWD= passwd 


is a password that must match the password entered by the 
operator in the START command or contained in a link 
definition table owned by VNET. If no password was entered in 
the START command cr contained in the VNET link table, this 
operand is not required. 


Input File Processing 


The remote terminal sukmits input to the VNET machine via the remote 
card reader. This input can ke directed to the virtual reader of a 
VM/370 user or to another remote terminal or location. Output processing 
at the remote terminal can be interrupted at any point to allow the 
transmission of input data. When the input has been processed, the 
cutput processing can te resumed from the point of interruption. 


A control card is placed in front of the deck to ke sent from the remote 
terminal to the virtual machine card reader of a user or to another 
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node or remote station. The card's format is described under "ID Card 
Format From Remote Stations" in the "Qperation Description" section. 


If it is possible (as on the IPM 3770) to enter the ID card data from a 
keyboard, upper case notation must be used. 


If the userid on the ID card is invalid, VNET spools the punch file to 
the real punch. 


Output File Processing 


When prirt and punch files are transmitted to a remote terminal, a 
header line is created on the output to identify the originating userid, 
date, and time of transmission. Card decks punched at the remote 
terminal contain the source header information on the first card 
punched; the rest of the card is filled with asterisks. Printer files 
use a Carriage control tape with channel 1 signifying the first print 
line. 


In addition to header information, printer files are separated from one 
another ky header pages which may be seen by the operator, at the edge 

of the unburst paper, to allow the operator to separate printed output. 
The format of the separator page is as follows: 


- page eject 

- skip 61 lines 

- 5 lines of n asterisks per line 
- 1 line of n underscores 

5 lines of n asterisks per line 
- 2 blank lines 

the source header line 

- page eject 

- the print file. 


where n is 120 or the numker of printable positions available on the 
remote printer, whichever is less. 


The card and print file header information is as follows: 


Col Field Meaning 
1 11111111 file origin location 
13 vnvmvmvm file origin virtual 
machine : 
25 XX /XX/XX file origin date 
37 yy: yy:vy file origin time 
47 XoXet. time zone 
55 WAS THE ORIGIN 


Remote Terminal Operator Commands 


The remote terminal operator is allowed to use a subset of the VNET 
ccmmands. The commands are punched on cards, beginning in column 1, one 
per card, and are read on the remote card reader. Ccmmand cards must 
precede the ID control card for an input file. In general, the remote 
operator can issue commands that affect only his specific link. The 
commands are described under "VNET Operator Commands". A complete 
description of all commands, with detailed format, can be found in 
"Appendix A: VNET Commands", 
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Note: With the exception of the MSG command, the linkid operand is not 
to be entered by a remote terminal operator when submitting commands to 
VNET. 


NPT Messages 


A subset of the VNET operator messages is printed on the remote terminal 
printer. Due to the unavailakility of a separate console printer for 
messages, and the resulting confusion which would ensue if messages were 
mixed with printer output, DMTNPT provides for a message queue. Whenever 
the remote printer has completed processing an output file, the messages 
that have keen queued, since the last message was printed, are 
transmitted and printed. Refer to "Appendix B: VNET Message Summary" 
for a key to the distribution of messages. 


STARTING VME 


Before communication with another remote VM/370 system can begin, the 
VMB line driver task for the associated link must Le started. This may 
be done automatically during system start-up or manually by the VNET 
operator. An example of the START command for VMB and the variables to 
ke specified is as follows: 


: Ra a aa a a a a aA aes. | 
| sTArt | linkid [TYPE DMTVME] [LINE vaddr] | 
| | (Parm tpass rpass] | 
a a a ee a ee ee | 
where: 


linkid is the location identifier of the remote system communicating 
with VMRB. 


CMTVMB is the name of the line driver to ke used with the newly 
activated link. This specification overrides the driver name 
that may have been previously defined for the link. If no 
driver was previously defined for the link, this field must be 
specified. 


vaddr is the virtual address of the communications line. (vaddr is 
used only if the line is to ke other than one previously 
specified in the link definition.) 


tpass is an optional operand, one to eight characters long, that 
specifies a password to be transmitted during the signon 
sequence. 


rpass is an opticnal operand, one to eight characters long, that 
Specifies a password that must ke received from the remote 
system before file transfer is initiated. If the transmit 
password, tpass (see akove), is specified and rpass is not, then 
a default rpass value the same as tpass results. 


For a full description of the START command, refer to “APPENDIX A: VNET 
Commands", 
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STARTING VMC 


Tc establish communication with another VM/370 system linked through a 
channel-to-channel adapter, a VMC line driver task must ke started. 

This may ke done autonratically during system start-up or manually by the 
VNET operator. An example of the START command for VMC and the 
variables to be specified is as follows: 


CARRERE RP CT GE CD EPCS Ge SE a Ce oS 


; nrarnpereracrmeraesS, | ey ee aa ponies | 
| STArt | linkid [TYPE DMTVMC] [LINE vaddr] | 
(__ S 


wheres: 


linkid is the location identifier of the remote node communicating with 
VMC. 


DMTVMC is the name of the line driver to be used with the newly 
activated link. This specification overrides the driver name 
that may have been previously defined for the link. If no 
driver was previcusly defined for the link, this field must be 
specified. 


vaddr is the virtual address of the communications line. (vaddr is 
used only if the line is to ke other than one previously 
specified in the link definition.) 


For a full description of the START command, refer to "APPENDIX Az: VNET 
Ccmmands", 


STARTING NJI 


Communication with systems cther than VM/370 is typically managed by the 
NJI line driver. The NJI line driver task for the desired link may be 
started automatically during system start-up or manually by the VNET 
Operator. The parameters cn the VNET start command for the DMTNJI line 
driver are as follows; 


o> «oo Gh ee ED GE GD EE GEE GED Ge 


linkid[ TYPE DMTNJI]{ LINE vaddr] 


| 


parm {Buff=nnnn } 
| {Rest=nnnn } 
| {RI Pass=password} 
| {RNPass=password} 
| {TLPass=password} 
| {TNPass=password} 
| 


_ 


{| Any comkination of the akove parameters may be entered | 


| separated by blanks. 
(___ .___ —______ ee 


wheres 


linkid is the location identifier of the remote station that is to 
cormunicate with CMINJI. 


CMITNJI is the name of the line driver to be used with the newly 
activated link. This specification overrides the driver name 
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which may have been previously defined for the link. If no 
driver was previously defined for the link, this field must be 
specified. . 


vaddr is the virtual address of the communications line. (vaddr is 
used only if the line is to ke other than one previously 
specified in a link definition.) 


Euff= is an optional keyword which is used to specify the 
communications adarter kuffer size for this link. This buffer 
Size may range from 300 to 1017 bytes, with a default of 400. 


Rest= is an cptional keyword which is used to specify the partial 
nodal resistance of this NJI connection. This number may range 
from 2 to 2000, with a default of 200. See System Programming 
Library: Network Jok Entry Facility for JES2, Order No. 

GC 23-0003. 


RIPass= is an optional keyword which is used to specify the line 
password required from the remote station before the 
transmission of data is initiated. The password specified may 
range from one to eight characters. If the correct password is 
not received at line connection time, the link is deactivated 
with a diagnostic error message (DMTNCM9O14F). 


RNPass= is an optional keyword which is used to specify the node 
password required from the remote station before the 
transmission of data is initiated. The password specified may 
range from one to eight characters. If the correct password is 
not received at line connection time, the link is deactivated 
with a diagnostic error message (DMTNCM914E). 


TLPass= is an optional keyword which is used to specify the line 
password to be transmitted to the remote station at line 
connection time. The password value may range from one to eight 
characters. 


TNPass= is an optional keyword which is used to specify the node 
password to be transmitted to the remote station at line 
connection time. The password value may range from one to eight 
characters. 


For a full description of the START command, refer to "APPENDIX Az VNET 
Commands". 


RESTARTING A LINE DRIVER 


Under normal operation a line driver will only need to be restarted if 
it has been deactivated Ey a DRAIN or FORCE command. Under these 
conditions issuing the START command appropriate to the line driver in 
question reactivates it. 


In the situation where a proklem occurs in the telecommunication 
facility of a link, the procedure required varies depending on the line 
driver type. 


The two VNET line drivers using the MULTI-LEAVING protocol, DMTSML and 
DMTINJI, previde a restart facility in the event of 40 consecutive 
three-second timeouts on the telecommunications adapter. When this 
condition occurs, the link is deactivated in such a fashion as to cause 
the execution cf an exec file with the filename identical to the 
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'linkid' of the link being deactivated. This exec (user generated) 
would normally contain a START command for the link just deactivated, as 
well as any other valid VNET command. 


The following example illustrates the contents of a file ‘NEWYORK VNET! 
an automatic execution file for restarting a link ‘NEWYORK'. 


CP .CLOSE 9 
START NEWYORK 


The execution of a DRAIN or FORCE command to a MULTI-LEAVING link will 
not cause the link's automatic restart execution file to be executed. 


The VME and VMC line drivers will not deactivate in the event of 
transmission line problenrs. If the line fails a message is issued. The 
message is "DMTXXX143I LINK ‘linkid" LINE 'vaddr' DISCONNECTED! or 
DMTXXX160I LINE ‘vaddr* CISAEFLEL FOR LINK 'linkid' depending on the 
problem. fhe line drivers will temporarily suspend transmission and 
attempt to autcmatically reinitialize and reenable the line. 


If the problem is momentary the messages, DMTXXX141I LINE ‘vaddr' REALY 
FCR CONNFCTION TO LINK ‘linkid! and DMTXXX142I LINK ‘linkid' LINF 
"'vaddr' CATASET READY are issued as the line is reestablished. 
Transmissicn of files resumes. 


If the problem persists the operator should check for any obvious 
problem in the data set or modem in the case of a leased line. For a 
dial-up line the oferator should redial to reestaklish the line 
connection. Transmission of files then resumes at the point of 
interruption. 


The NPT line driver will deactivate in the case of severe line 
interruption. In this case the line froblem must be resolved. 

Following the reestablishment of a functioning transmission line a START 
command must be issued to the NPT line driver to re-estaklish the link. 


DYNAMIC FECONFIGURATION 


The commands available to the VNET system operator provide the ability 
to dynamically alter the VNET system configuration. Entries in the link 
and route tables can be added, deleted, or modified while the system is 
running. This enables the VNET system operator to respond immediately to 
changes in the operating environment of his node. If the normai 
transmissicn path for a link becomes unavailable, the route table can te 
altered to direct files te another link that provides a path to the file 
destination. If it becomes necessary to process a particular class of 
files first, a link can ke redefined in the link table to access only 
the specified class of file fcr transmission. 


CHANGING THE ROUTING TABLE 


To change an entry in the routing table, issue a ROUTE command from the 
VNET operator's console. Specify the location ID for the remote location 
whose routing is to be modified or redefined. Also specify "TO linkid" 
defining the link that will process the files directed to the remote 
location. VNET issues a message in response to the ROUTE command, 
reporting the result of the command. Files awaiting transmission are 
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automatically reenqueued following execution of a ROUTE command. For a 
detailed description of the ROUTE command see “Appendix A, VNET 
Commands", 


Changes to the routing takle remain in effect until the next VNET system 
IEFL. Permanent changes can only Le made Ly altering the VNET directory. 


CHANGING THE LINK TABLE 


To change an entry in the Link Table, issue a DEFINE or DELETE command 
from the VNET operator's console. Before altering or deleting an entry 
for an active link, the lirk must first be made inactive by issuing a 
DRAIN command specifying the "linkid". 


Tre DEFINE command is used to create temporary new link entries, 
redefine an entry that was deleted, or alter an existing entry in the 
Link Table. The DELETE command is issued to temporarily "undefine" a 
link and make it unavailakle to the VNET system. 


VNET issues messages in regspcnse to both the DEFINE and DELETE commands. 
For a detailed descripticn of the DEFINE and DELETE commands see 
"Appendix A: VNET Commands", 


Changes to the Link Table remain in effect until the next VNET system 
IFL. Permanent changes can only ke made by altering the VNET directory. 
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: VM/370 USER GUIDE 


Part 4 is a guide for the VM/370 

user who needs to use the VNET system 
during the course of his work. 

The following main areas are covered. 


1. The commands the user needs 
to work with the VNET system. 


2. Examples of VNET usage. 


3. Messages a VM/370 user may 
expect while using VNET. 
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VM/370 USER COMMANDS 


The interface ketween a VM/370 user and the VNET virtual machine 
consists of the SPOOL and TAG commands along with the spool file tag 
associated with every output spool file generated by a VM/370 user. 


VM/370 SEFOCI COMMAND 


All files to ke transmitted via VNET must be spooled to the VNET virtual 


machine. The form of the CP SEOOL command used with VNET is as follows: 
Fr eee pee es © f Pies Ga ee ea sg ey a ee FS gee 
| | {Printer} | 
[| SPool {| {PUnch } [TO] userid | 
| {CONsole} | 
| {vaddr } | 
la es ee ee a ee ee 
wheres: 
PRINTER denotes all printer class device 
PRT out put. 
PUNCH denotes all punch class device 
PCH output. 
CONSOLE denotes all ccnsole class device output. 
vaddr denotes all output from the specified virtual device 
address. 
userid is the ID of the virtual machine in which VNET resides. 


Note: Other SPOOL command options, such as CLASS and COPY, can also be 
specified; see the VM/370: Command Language Guide for General Users. 


VM/370 TAG 


The VM/370 
file tag. 


COMMAND 


CP TAG command is used to enter or query data in the spool 
The command has three functional formats: 


e Tag contents may be prespecified for all output files from a 
particular category of output devices or from a single output 


device. 


e Tag contents for an existing closed spool file may be replaced. 


e The tag contents associated with an output device contained in a 
closed output file may ke displayed. 
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The TAG 


eee SS ee ee EE ee SS ES cen GE EE ee 


r 


command syntax is as follows: 


DEV 


FIle 


QUery { 


| 
| 
| 


{Printer} 

{PUnch } [tagtext ] 
{CONsole} 
{vaddr } 
spoolid [{tagtext] 
{ {Printer} } 
{DEv {PUnch } } 


{ {CONsole} } 
{vaddr } } 


Nene ged Nenged ered ged eed et ed owed ed ed teed teed 


{ } 
{FIle spoolid } 
a me ee es se Se rw amet Nae Se dan ea en 


The first operand of the TAG command specifies the function to be 


performed: 


DEV 


FILE 


QUERY DEV 


QUERY FILE 


PRINTER 
PRT 


PUNCH 
PCH 


CONSOLE 


vaddr 


spoolid 


tagtext 
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allows the user tec perform the initialization, replacement, 
or deletion of the tag data associated with an output 
device. All spool files, generated by the device specified 
in the second oferand, will contain the tag data entered in 
the third operand. If there is no third operand, the tag 
data will be LElank. 


allows the user to replace the entire tag data of any spool 
file queued on his virtual reader and identified by the 
second operand with the new tag data specified in the third 
operand. This allows the user to correct the tag of a file 
returned to his reader queve by VNET because of an invalid 
address in the tag. If there is no third operand, the tag is 
set to blanks. 


allows the user to display the current setting of the tag 
information associated with the output device or device class 
specified in the third operand. 

allows a user to display the tag information of any spool 
file queued on his virtual reader. The specific file in his 
reader queue is identified by the third operand. 


is the synonyr fcr all printer class devices. 


is the synonym for all punch class devices. 


is the synonynr for all console class devices. 
is the virtual device address of a virtual unit record device 
or console. 


is the unique identificaticn number assigned to a spool file 
by the VM/370 spooling facility. The numbers range from 1 to 
9900. 


is the new or replacement tag data used in the TAG DEV and 
TAG FILE format of the command. The entire command line to 
the right of the third operand (beginning with the leftmost 
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non-blank character to a maximum of 136 characters) becomes 
the new contents of the tag for the specified device, device 
class, or specific file. If no text is specified, the 

Cc contents of the tag are set to Elanks. 


TAG QUERY COMMAND RESPONSES: 


{PRINTER} 
TAG QUERY CEV {PUNCH } 
{CONSOLE} 
{VADDR _ } 
é Displays the contents of the tags associated with each device of the 


specified class as follows: 


= 
; {PRT } | repeated for 
{PUN } vaddr TAG: { each device in 
{CONS} | the specified 
{VADIDR} | class 
Cag CORE 5.50 5s Sire cake oe: | 
| 
( TAG QUERY CEV vaddr 
Cisplays the contents of the tag associated with the specified device as 
fcllows: 
{PRT } 
{PUN } vaddr TAG: 
{CONS} 


Cagtext.cccccccee 
if tag data exists 


TAG NOT SET 
if the TAG command was never issued to that device. 
Pa TAG QUERY FILE spoolid 


Cisplays the contents of the tag associated with the specified file as 
follows: 


Cagtexteccccccecce 
if tag data exists 


(TAG BLANK) 
if the tag is all blanks 


(TAG MISSING) 
. if the file did not contain a tag because it was either 
an input file from the real card reader or was an output 
file generated before VM/370 Release 2 PLC 11. 
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VNET USAGE OF TAG AND SPOCI COMMANDS 


momen ee ee 


When a VM/370 user creates a file that is intended for transmission toa 
remote location via VNET as a JOB file, the syntax of the spool file tag 
data is: 


, aes ee ee ee ee one Cae aly Cee On tera 
| | q i yV 
| TAg | DEv vaddr locid |fuserid| | priority [JOB] | | 
| JoB | | | 
| t J L J ! 
Ll Sa en as cs ae a a ee ee ee ee 
wheres: 
vaddr is the virtual device address for which the TAG is set. 
lecid is the lccation identifier of the destination location for 
output generated Ly this virtual device. 
userid is the identification of the remote virtual machine or remote 


station at the specified location that is to receive the 
output generated by this device. 


priority is the requested transmissicn priority (a decimal number 
0-99), defaulting to 50, implying a higher priority with lower 
numerical value. 


JOB a keyword indicating that the output of this punch device be 
transmitted as a job. 


The additional parameter on the VM/370 TAG command when interfacing to a 
non-VNET system for the transmission of OUTPUT is as follows: 


Note: The specification cf any of these parameters does not imply the 
support of these features on the suksystem at the output location. 


SS ee 


—— =m) 


TAg DEv vaddr locid [userid] priority 


[rmtid ] 


{FCB[ C J=carriage 
{FORMS[ F J=formstype 
{UCS[ T J=train 
{INDEX[ I J=index 
{EXTKUTRE W J=writename 
{BURST{ E ]=Y|N 
{OPTCD=J 
{CHARS[ X J=tran 
{COPYG[G J=nn 
{FLASH[ 0 J=flash 
{FLASHC[ Q J=nn 
{MODIFY[ Y ]=modify 
{MODTEFC[ M]=0|1]2[3 


ON ps a, ET ca EGER ey ESE oe ergy EE EE We OS ES ee 
Reged Noel Ned Nye eyed yet bend Cyt bey bed eyed eed ee 


Any combination of NJI keywords may Le specified separated 
Fy blanks up to a total tag length of 136 characters. 


The accepted abbreviation for each keyword is shown enclosed in f[ ]}. 
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where; 
vaddr 


lecid 


userid 


rrtid 


priority 


FCB= 


FORMS= 


UCS= 


INDEX= 


EXTWTR= 


is the virtual device address for which the TAG‘’is to be set. 


location identifier of the destination location for 
generated ky this virtual device. 


is the 
output 


is the identification of the remote virtual machine 
or remote work station at the specified location that is to 
receive the outfut generated by this device. 


is the requested transmission priority (a decimal number 
0-99), defaulting to 50, implying a higher priority with lower 
numerical value. 


is a keyword indicating the forms control kuffer for printing 
the output of this device. This specification can be from 1 
to 8 characters. 


is a keyword indicating the special forms for printing the 
output of this device. This specification can be from 1 to 8 
characters. 


is a keyword indicating the 
printing the output of this 
from 1 to 8 characters. 


universal character set for 
device. This specification can ke 


is a keyword indicating the 
for the 3211 printer. This 


data set indexing position offset 
parameter may range from 1 to 31. 


is a keyword indicating the external writer to process the 
output of this device when it is printed or punched at a 
remote location. 


The following parameters are specified if the receiving subsystem is to 
print the data from this device on the 3800 printer and does not imply 


VM/370 support of that device. 


Currently the only subsystem supporting 


the 3800 printer is JFS2. 


EURST= 


OPTCD=J 


CHARS= 


COPYG= 


is a keyword indicating whether the output from this device 
should be threaded inte the Burster-Trimmer-Stacker on the 
3800 printer. This parameter must be either Y or N. 


is a keyword which indicates that each line of data produced 
ky this device contains a table reference character for the 
3800 printer. 


is a keyword which indicates the names of character 
arrangement takles, which define the characters for printing 
on the 3800 printer. This specification can be from 1 to 8 
characters and may ke specified up a maximum of four times, 
once for each translate table desired. 


is a keyword which indicates the copy grouping for the output 
of this device when printed on the 3800 printer. Each group 
up to 8 can range from 1 to 255. This parameter may be 
specified up a maximum of eight times indicating eight copy 
groups. 
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FLASH= 


FLAS HC= 


MODIFY= 


MCDT kC= 


is a keyword which indicates the name of the forms overlay 
frame to be used when frinting the output of this device on 
the 3800 printer. This specification can be from 1 to 8 
characters. 


is a keyword which indicates the number of the total copies of 
the output of this device on which the forms overlay is to be 

printed on the 3800 printer. This parameter can range from 1 

LO 255% 


is a keyword which indicates the copy modification module to 
ke used in rodifyirg the data, produced by this device when 
printed on the 3800 printer. This specification can be from 1 
to 8 characters. 


is a keyword which indicates the table reference character for 
selecting which character arrangement takle is be used when 
printing the output of this device on the 3800 printer. This 
parameter can ke either be 0, 1, 2, or 3. 


If userid is not applicakle, as in NPT and SMI support, and priority is 
to be specified, a dummy userid must ke included. 


The remainder of the 136 byte tag is ignored by VNET. 


To specify that all printer output is to be transmitted to Houston, a 
VM/370 user would enter the following commands: 


TAG DEV PRINTER HOUSTON 
SPOCI FRINTER TO NET 


where HOUSTON is the location identifier of the receiving station and 
NET is the userid of the VNET virtual machine. 


If one particular output device is to have its output transmitted to 
Palo Alto with a priority of 10 and no userid specified, the VM/370 user 
would enter the following commands: 


TAG CEV OOD PALOALTO SYSTEM 10 
SPOOL OOD 10 NET 


where OOD is the virtual output device address; PALOALTO, the location 
identifier of the receiving station; SYSTEM, a dummy userid entry; 10, 
tke priority value; and NET, the userid of the VNET virtual machine. 


The VM/370 user may want to set up a CMS FXEC file tc handle remote 
Spooling oferations. A sample of such an EXEC, called SEND, follows: 


SEFOOL &2 TO NET 


TAG 
& 2 


DEV &2 6&1 
63 6&4 


SPOOL &2 OFF 


The FXEC would Le invoked as follows: 


SEND PALCALTO PRINT PROG LISTING 


The EXEC executes as follows: 


SPOCL PRINT TO NET 


TAG 


DEV PRINT PALOALTO 


PRINT PROG LISTING 
SPOCLI PRINT OFF 
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USER EXAMPLES AND MESSAGES 


USER EXAMPLES 


This section illustrates several examples of VNET usage. It is not 
intended to shcw complete examples of the usage of VNET in conjunction 
with the JES2/NJE program product and the PRPQs for ASP and HASP. Users 
of a mixed environment of NJE/NJI suksystems should refer to the related 
publications listed in the Preface. The examples presented here provide 
samples of the types of facilities available. 


Example 1. Specifying Destination of VM/370 Virtual Output 


A CMS user on a VM/370 system in NEWYORK wants the output from his 
virtual printer directed to BOSTON. Assuming a network configuration as 
shown in Figure 7(Part 2 of this manual), with the NEWYORK/EOSTON link 
temporarily inactive, the following illustrates the user's console: 


Spo e to net 


R5 

tag dev e koston syster 

R; 

pr profile exec 

PRT FILE 0150 TO NET COPY 01 NOHOLD 
R5 


12359: 26 
MSG FROM NET : SENT FILE 0150 (0150) ON LINK 
TORONTO TO EFOSTON SYSTEM 


12:59:36 
MSG FROM NET : FROM TORONTO: SENT FILE 0386 (0150) 
ON LINK EOSTON TO EOSTON SYSTEM 


Note that the spool ID assigned at the originating system by VM/370 is 
returned in each network resfonse message as the file proceeds through 
the network. Also, the path the file took to its final destination was 
determined by VNET. The user specified only the final destination for 

file processing. 


Example 2. VNET Job Submission to a Batch Processor 


This example illustrates a CMS user at location NEWYORK submitting a JOB 
to an ASF NJI system in RUFFALO. Output returning from a batch job 
submitted through VNET will ke processed by the real unit devices 
attached to VM/370 unless overridden by the user via JCL. 


User RALPH wants a source deck assembled at BUFFALO and the resultant 


okject deck and message data set returned to his virtual machine 
reader. He wants the assenkly listing printed on an offline printer. 
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The following illustrates the JCL he might use with the source deck: 


//CCMPILE JOE 1,MSGCLEVEL=1,NOTIFY=RALPH =) 
S*MAIN SYSTEM=ANY 

/*FORMAT PR CUONAME=SYSMSG,DEST=NEWYORK. RALPH 

/*FORMAT PU DCONAME=,CEST=NEWYORK.RALPH 

S/STEP EXEC ASMFC 

//ASM.SYSIN DD * 


TEST 


/* 


CSECT 
ENC 


The NOTIFY keyword on the JOE card causes any TSO NOTIFY messages 
produced ky the katch processing system to be returned by the network to 
the CMS terminal. 


The following illustrates the terminal session for the job: r 


tag dev d kuffalo system 50 job 


R5 


spo d to net 


pun corpile job (noh 


PUN FILE 


16:57:47 
MSG FROM 


16357354 
MSG FROM 
PRT FILE 
16:58:02 
MSG FROM 
PUN FILE 


165.582 C5 
MSG FROM 


8921 TO NET COPY 01 NOHCLD 


NET : SENT FILE 8921 (8921) ON LINK 
BUFFALO TO BUFFALO SYSTEM 


NET : FROM EUFFALO: AMSV01 JOB 5880, 
COMPILE IS ON SYS BE 

8923 FROM NET COPY 01 NOHOLD 

NET : FILE (8921) SPOOLED TO RALPH -- ORG BUFFALO 
(SYSTEM) 10/17/7€ 16:57:59 E.D.T. 

8925 FROM NET COPY 01 NOHOLD 


NET : FILE (8921) SPOOLED TO RALPH -- ORG BUFFALO 
(BUFFALO) 10/17/7€ 16:59:59 E.D.T. 


Example 3. WVNET Output Transmission Using Special Forms 


This example 


illustrates the transmission of spool output from a VM/370 


system tc a remote batch system that has special forms capability. This J 
CMS user wants the output from his virtual printer directed to BUFFALO 

to be printed on white paper uSing a text (TN5) print train. The 

fcllowing illustrates the users console: 


spo € to net 


R; 


tag dev e kuffalo system 50 f=white t=text 


R; 
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print profile exec 
PRINT FILE 0118 TO NET COPY 01 NOHOLD 
R; 


12:55:49 
MSG FROM NET : SENT FILE 0118 (0118) ON LINK 
BUFFALO TO BUFFALO SYSTEM 


Example 4. VNET JOB Submission With Special Output Processing 


This example illustrates a jok running on a HASP batch processor with 
the output to ke printed at a VM/370 node with a VM output class. VNET 
sets the output class from the first character of the batch system forms 
specification. 


//EXAMPLE JOE 1, MSGLEVEL=1 
/*OUTPUT 1234 DEST=MIAMI,F=R 
J/STEP EXEC ASMFEC 

//SYSPRINT CC SYSOUT=(A,,1234) 


J/SYSIN DD * 
TEST CSECT 

END 
/* 


When the jok executes the SYSPRINT data set is printed at node MIAMI 
with VM cutrfut class '‘R*. 


USER MESSAGES 


This section centains a list and a short description of messages 
directed to the console of the virtual machine user Ly VNET. For a 
detailed description of each message see "Appendix B: VNET Messages", 


C¥YTAXM101I FILE ‘spoolid' ("orgid') ENQUEUED ON LINK ‘linkid' 


The user file specified is accepted by VNET and is ready for 
transmission. 


CMTAXM102I FILE ‘spoolid' ('crgid') PENDING FOR LINK ‘'linkid' 


The link specified has no tag slot available for the user 
file. The file is held by VNET and enqueued automatically as 
Space becomes available. 


DMTAXM103E FILE 'spoolid! ('orgid') REJECTED -- INVALID DESTINATTON 
ACCRESS 


The file specified is returned to the user if the origin is 
local, otherwise it is purged. The destination address in the 
tag did not match any VNET route or link table entry. 


CMTAXM104I FILE ('orgid') SPOOLEL TO ‘userid’ -- ORG ‘locid' (userid2) 
mm/dd/yy hh:zmmrs:ss 


A file has arrived from a remote location and is awaiting 
user disposition. The file originator is identified. 


DMETAXM111I User ‘userid! NOT IN CP DIRECTORY -- FILE ('orgid') spooled 
TO SYSTEM 


A file received Ly VNET was addressed to a local user 


"userid! which is not in the local VM/370 system directory. 
The file had an origin spool ID of ‘orgid'. 
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DMTxxx147I SENT FILE 'spoolid' (torgid') ON LINK 'linkid' TO 'locid' 


fuserid' 


The specified file has been successfully fassed to the next 
node in the network 


CMTxxx17C0I FROM 'locid': (message text) 


DMTxxx171I FROM 'locid' (‘'userid'): (message text) 


These messages identify the source of the accompanying text 
on the user console. 


CMTSML93S5E LINK 'linkid IN RJE MCDE -- PRINT FILE 'spoolid! PURGED 


The specified link is working as a submitting RJE workstation 
and cannot accept print files. 


DMTNPT936E NO REMOTE PUNCH AVAILABLE ON LINK tlinkid! -- FILE 'spoolid' 


PURGELC 


The terminal specified is not capable of producing the user 
specified punched output. 


MANAGING RETURNED FILES 


VNET rejects any file that dces not contain in its tag a destination 
address that matches an entry in the VNET route or link takles. The file 
is returned to the virtual reader queue of the originating local virtual 
machine user. The file tag rust ke corrected and the file resubmitted to 
VNET. The following example with the VNET virtual machine ID of ‘'NET!* 
Shows how this is done. 
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1. 


The 


The user directs a print file to VNET for transmission by 
issuing TAG and SPOOL commands. 


TAG DEV OOF HOYSTON 
SPOOL OOE to NET 


destination address "HOYSTON" is incorrect. 
The user issues a PRINT command. 


VM/370 responds with the message "PRT FILE 6783 TO NET". The 
spoolid of the file is 6783. 


VNET examines the file tag and finds no match in the route or 
link takles. The file is returned to originator's virtual 
machine reader. 


VM/370 issues a message to the user "RDR FILE 6783 TRANSFERRED 
FROM NET", VNET issues a message to the user "MSG FROM NET: FILE 
6783 REJECTED -- INVALID DESTINATION ADDRESS", 


The user corre~ts the tag and resukmits the file. The tag is 
corrected by : suing a TAG FILE command "TAG FILE 6783 HOUSTON", 
The file is resukmitted Ly issuing a TRANSFER command "TRANSFER 
6:7:33- TO. NET". 


VNET accepts che file and enqueves it on the link required to 
reach the destination "HOUSTON", 
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Fefore further files are to ke sent, the tag for the user's virtual 
printer should be corrected Ly reissuing the TAG Dev command with the 
correct address 'HOUSTON'. 
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PART 5. APPENDICES 


Appendices contain detailed descriptions 
of all commands and messages, plus 
reference information cn communicating 
with remote stations and terminals. 
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APPENDIX A: VNET COMMANES 


Appendix A contains a detailed descriftion of the VNET commands. The 
messages resulting from the use of each ccmmand are included in the 
description of the command. 


NOTATIONAL CONVENTIONS 


The notation used to define the command syntax in this publication is described 
in the following paragraphs: 


1. Truncations and Abbreviations of Commands 


Where truncation of a ccmmand name is permitted, the shortest acceptable 
version of the command is represented by uppercase letters. 

(Remember, however, that VNET commands may be entered with any 
combination of upper and lcwercase letters.) 

The example below shows the format specification for the BACKSPAC command. 


FAckspac 


This representation means 

that EA, BAC, BACK, BACKS, RBACKSP, BACKSPA, and BACKS PAC 

are all valid specifications for this command name, 

aS are any of those ccmbinations in which lower case characters 
are substituted for their upper case equivalents. 


Operands and options are specified in the same manner. 

Where truncation is permitted, the shortest acceptable version 

of the operand or option is represented by uppercase letters 

in the command format kox. 

If no minimum truncation is noted, the entire word (represented by all 
Capital letters) must ke entered. 


2. The following symbols are used to define the command format and should never 
be typed when the actual command is entered. 


underscore 

braces { 
brackets [ 
ellipsis ° 


3. Uppercase letters and words, and the following symbols, should be 
entered as specified in the format kEox. 


asterisk * 
comma ’ 
hy phen = 
equal sign 
parentheses ( ) 
period ° 
colon : 
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6. 


8. 


90 


Lowercase letters, words, and symbols that appear in the command 
format box represent variables for which specific information 
should be substituted. For example, in the BACKSPAC command, 
linkid represents a variable link identifier, such as NEWYORK. 


Choices are represented in the command format boxes by stacking. 


Qt 2 


An underscore indicates an assumed default option. If an 
underscored choice is selected, it need not be specified when the 
command is entered. 


Example: 


The representation 
A 
E 
Cc 


indicates that either A, B, or C may be selected. However, if B is 
selected, it need not be specified. Or, if none is entered, EF is 
assumed. 


The use of kraces denotes choices, one of which must ke selected. 


Exarple: 


The representation 


e— A—s 
OW .Y 
— Vol 


indicates that you must specify A, B, or Cc. If a list of choices 
is enclosed by neither brackets nor kraces, it is to ke treated as 
if enclosed by kLraces. 


The use of brackets denotes choices, one of which may be selected. 


Example: 


The representation 


r—_——_——s 
Ow py 


| 
| 
| 
J 


indicates that you may enter A, B, or C, or you may omit the 
field. 
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9. An ellipsis indicates that the preceding item or group of items may 
be repeated more than once in succession. 


Example: 
The representation 
(options...) 


indicates that more than cne option may be coded within the 
parentheses. 


OFERATOR COMMAND USAGE 


The VNET commands descriked kelow can be issued by either the VNET 
operator or the remote station operator with the following exceptions: 


e CLOSE, CP, CEFINE, DELETE, CISCONN, EXEC, FORCE, REORDER, ROUTE, 
SHUTDOWN, TRACE, and TRANSFER commands may be executed only by the 
VNET operator. 


e START has limited functional capabilities when issued by a remote 
station operator. (See the START cecmmand description.) 


e Commands, issued by a remote station operator, affect only the status 
of that station's link. With the exception of the MSG and the QUERY 
command, the linkid operand must not be specified in a remote station 
command line. 


File attrikutes which are these of the VM/370 spool system, and the 
operands describing them in the VNET command language, have maximum 
values and default values identical tc those of the VM/370 command 
language and system. Command names and keywords may be specified by 
typing any part of the command name or keyword from the minimum 
truncation to the full name. The minimum truncation in each case is 
indicated by upper case letters. 


VNET COMMANDS 
* (COMMENT) 


The * command performs no function, and is accepted Ly the command 
processor as a valid command which produces no response messages. The * 
ccmmand line may be entered directly from the VNET operator console or 
from a ccmmand EXEC procedure. The intent of this command is to provide 
a means of annotating VNET operator console listings. The format of the 
* command is: 


Fa ee eee ag eg ee ee ee ae Pa Ge ee te Ne EN Te ee 
{ [any comment text] | 
CS nee ee eee ee ee ee ee ee ee eee ee Ss Se 


% 


Responses: 


None. 
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BACKSPAC 


The BPACKSPAC command causes the current file being transmitted to be 
restarted or repositioned kackward. This command is not supported by 
the CDMTVME, DMTVMC, or DMTNJI line drivers. The format of the BACKSPAC 
ccmmand is: 


Ce SS 


| c :) 
BAckspac | (linkid] File | 
| | 
| J 


| 
| 
| 
L 


where: 


linkid is the one- to eight-character link identifier for the 
link on which the current file being transmitted is to be 
repositioned. If the command is issued by the VNET 
operator, this operand must be specified; if issued from 
a remote station, it must ke omitted. 


FILE is a keyword which specifies that the file being 
transmitted is to be restarted from the beginning. 


nnn is the number of data units to ke kackspaced. For a 
print file, data unit refers to printer pages, which are 
counted in the same way as for the analagous VM/370 
spooling command. For a punch file, data unit refers to 
file records which include any write type command code. 


Responses: 


DMTxxx510I FILE 'spoolid' EACKSPACED 
DMTxxx511E NO FILE ACTIVE ON LINK 'linkid' 


CHANGE 


The CHANGE command alters cne or more attributes of a spool file owned 
by the command originator. In order to affect a file using the CHANGE 
ccmmand, the file must be inactive (that is, no link may be actively 
processing it). The format for the CHANGE command is: 


c gs ee ee fee Ne ge Pe ge ge a eae oe ae ee pee 
| | { r + Hl 
| CHange {flinkid] spoolid { PRIority nn Name [fn {ft}|/} | 
| { CLass c dsname } | 
| | { COpy nn a ae 
| | { HO1d|NOHold } | 
| | { DIst distcode } | 
| | | 
L ee | 
where: 

linkid is the one- to eight-character link identifier for the 


link on which the file to be changed is enqueued. If the 
command is issued by the VNET operator, this operand must 
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spoolid 


PRIORITY nn 


CIASS c 


COPY nn 


HOLD 


NOHOLD 


CIST distcode 


NAME fn (ft) 
NAME dsname 


Responses: 


DMTAXM5201I FILE 


» 


be specified; if issued from a remote station, it must ke 
omitted. : 


is the nureric spool file identifier for the file which 
is to ke changed. 


designates the new transmission priority for the file. 
nn is a decimal number from 0-99 with 0 signifying the 
highest priority. 


designates the new class for the file. cisa 
one-character alphameric field frem A to Z or from 0-9. 


alters the number of copies to be made of the file. The 
value of nn (number of copies) must be a number from 1 
through 99. For nn less than 10, the leading zero is 
optional. 


prevents the processing of the file until it is released 
by a CHANGE ccmmand specifying NOHOLD. 


releases the specified spool file if it had been in HOLL 
status. 


changes tke distribution code of the specified file. 
distcode is a one- to eight-character identification to 
be associated with the file. 


changes tke name of the specified file. If specified, 
this operand must be the last entry in the command line. 


*"spoolid! CHANGEL 


CMTAXM5211I FILE 'spoolid' HELD FOR LINK 'linkid' 


DMTAXM5221I FILE 
DMTAXM523I LINK 
DMTAXM524E FILE 
CMTAXM525E FILE 
CMTAXM526F FILE 


CLOSE 


"spoolid' RELEASED FOR LINK !linkid' 

"linkid' QUEUE REORDERED 

*"spoolid’ ACTIVE -- NO ACTION TAKEN 

"'spoolid' IS FOR LINK 'linkid' -- NO ACTION TAKEN 
"spoolid' NOT FOUND -- NO ACTION TAKEN 


For VNET Operator Only 


The CLOSF ccmmand causes cne or more active files on an inactive link to 


be deactivated. 


Active input files are reenqueued as inactive files, 


and subsequent retransmission Legins at the start of each input file. 
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Active output files (which are normally incomplete) are discarded. The 
format of the CLOSE command is: 


RE GR ES ER Re RA OE CS ia a A a RR | 


- 
Close { ALL | 
| INput | 
| OUTput | 
| Spoolid: sce ss. .| 
L J 


A a eR eG RSE a SS A a a I ED ED PS 8 IS CEE CR EY 


Only one keyword may ke entered. If no keyword is entered, a default| 
| of ALL is assumed. | 


En, CE ae , , a i | 


u et ee ja a a a a a a a ee 

where: 

linkid is the one- to eight-byte link identifier for the link on 
which the files to be closed are enqueuved. The specified 
link must ke inactive when the CLOSE command is issued. 

ALL is a keyword which specifies that all active input and 
output files are to ke deactivated. Active input files 
are deactivated and reenqueuved. Active output files are 
deactivated and purged. 

INPUT is a keyword which specifies that the all active input 
files for the specified link are to be deactivated and 
reenqueued. 

OUTPUT is a keyword which specifies that all active output files 
for the specified link are to be deactivated and purged. 

spoolid ... Specifies particular input file(s) to be deactivated and 


reenqueued. 


Responses: 


DMTAXM500I nn FILE(S) CLOSED ON LINK ‘linkid' 


DMTAXM5O1E LINK ‘linkidt ACTIVE -- NO FILE(S) CLOSED 
DMYTAXM502E FILE ‘spoolid' INACTIVE -- NO ACTION TAKEN 
CMD 


Wren issued with a text operand, the included text is interpreted as a 
remote syster ccmmand and is forwarded for execution at the specified 
location. The format of the text must conform to the command syntax of 
the particular system to which the command is addressed. The local VNET 
performs no processing cn the remote system command which is entered. 
The CMD command provides the means by which operators and users can 
execute allowable query and control functions at remote systems. The 
format of the CMD command is: 


| 
CMD | locid text 


ec——-—4 
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wheres: 


locid is the one- to eight-byte location identifier of the 
remote system which is to receive and execute the command 
specified in the text line. 


text is an arbitrary string of alphameric characters 
comprising the text line to be presented to the remote 
location as a system command. The maximum length of the 
character string is 120 characters. 


(Format requirements for this string are dependent on the 
type of remcte system implied by locid.) 

Responses: 

CDMTxxx302E LINK 'linkid' IS NOT CEFINED 

CMTxxx303E LINK 'linkid' IS NOT ACTIVE 


DMTCMX310E LOCATION ‘locid! IS NOT DEFINED 
DMTxxx320E LINK "linkid' NCT CONNECTEL 


CP 


For VNET Operator Only 


The CP command transmits commands to the VM/370 Control Program without 
leaving the VNET command environment. The format of the CP command is: 


a Ei 
CP | {command line} | 


cd SS ee ee es eS ee eS Se Sed 


es 


where: 


ccmmand line is any CP command permitted for the command privilege of 
the VNET virtual machine. The omission of this field 
will produce error message DMTCMX204E. 


Responses; 


None. (Response from CP may result.) 


DEFINE 


For VNET Operator Only 


Tke DEFINE ccmmand causes a new link to ke temporarily added to the set 
of valid links for the local VNET installation, or causes an existing 
inactive link definition tc ke temporarily redefined. Permanent link 
definitions and changes can only be made by modifying the VNET 
directory. Files addressed to the remote station whose location ID is 
identical to the link ID may ke processed after the link has been 
defined. Up to sixteen new links may be temporarily defined. 
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The format of 


DEFine 


-——— 4 


where: 


linkid 


CIASS c 


KFEP holdslot 


LINE vaddr 


TASK name 


TYPE driverid 


ZONE zoneid 


2S 6 > GE EO OY SE Ge EO ee ee ee EES CED aah CaS ES ee 


the DEFINE command is: 


linkid { } 
{ KEEP holdslot } 
{ LINE vaddr } 
{ TASK name } 
{ TYPE Griverid } 
{ ZONE zoneid } 


_ 


is the one- to eight-character link identifier for the 
new link to ke defined, or for the existing link to ke 
redefined. 


specifies the classes of files which may be processed by 
the active link. c can be either *, meaning all file 
classes may Le processed, or from one to four classes 
(Single characters with no intervening blanks). If no 
classes are specified, the default is *. 


specifies the numker of virtual storage file tag slots to 
ke reserved for exclusive use by the link being defined. 

"holdslot" is a decimal numker from zero to Sixteen. If 

the KFEP parameter is omitted, a default value of two is 

assumed. 


designates the virtual device address (vaddr) of a 
permanent telecommunications port to be used for 
processing files for the affected link. If this 
parameter is omitted, the LINE definition defaults to 
undefined. 


designates a task name for use by the line driver 
associated with the link. name is a one- to 
four-character alphameric identifier. If this parameter 
is omitted, the task definition defaults to undefined. 


designates the name of the line driver which is to be 
associated with tke link. driverid is a one- to 
eight-character name of the line driver to be used 
(DMTSML, CMINPT, DMTNJI, DMTVMB, or DMTVMC). The proper 
line driver to use with the link depends on the type of 
remote telecommunications system involved. If a new link 
is being defined and this operand is not specified, the 
type definiticn defaults to undefined. 


specifies the number of time zone koundaries between the 
remote location and Greenwich to the east, the 
International Vate Line being included as a time zone 
boundary. If the ZONE parameter is omitted, a default of 
0 (Greenwich Mean Time) is assumed. 
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Responses: 


DMTCMX540I NEW LINK 'linkid' DEFINED 

CMTCMX541I LINK '‘linkid' RELCEFINED 

CMTCMX542E LINK 'linkid' ACTIVE -- NOT REDEFINED 

DMTCMX543F LINK 'linkid' NOT DEFINED -- LINK LIMIT REACHED 
DMTCMX653I LINK *linkid' CEFAULT 'task' ‘type’ 'vaddr' c Z=z R=r 


DELETE 


For VNET Operator Only 


The DELETE command causes a previously defined link to become 
temporarily undefined. Permanent deletion of a link can only be made Ly 
deleting the entry from the VNET directory. The link to be deleted must 
ke inactive and must have no files enqueued or pending at the time the 
DELETE command is issued. Files addressed to an undefined link are 
rejected as invalidly addressed. 


na 
DFIlete linkid 
| | 


c panera Ne ee | 

wheres: 

linkid is the one- to eight-byte link identifier for the link 
which is to ke undefined. 

Responses: 

DMTCMX550I LINK ‘linkid't NOW DELETED 

DMTCMX551E LINK *linkid! ACTIVE -- NOT CDCELETED 

CMTCMX552E LINK tlinkid' HAS A FILE QUEUE -- NOT DELETED 


CISCONN 


For VNET Operator Only 


The DISCONN command causes the VNET operator console to be disconnected 
from the VM/370 system while VNET continues to operate. The VNET 
CISCONN command operates the same as the VM/370 DISCONN command, except 
that another userid may be specified to receive all VNET operator 
ccensole output lines. If no userid is specified, the VNET console 
output lines are discarded without being printed. In order for the VNET 
operator to reconnect his console, he must log on to the system again. 
The format of the DISCONN command is: 


ge Re ee Te ig Pe ES Pee ey Tp hey Pe aN Pe aE NS ee ae eS ET Ge ee a EM ee ee el 
| DbIsconn | { userid ] | 
t a a ee an Sr a ae a Sa a a ce ea ule a i i ml 
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wheres 


userid is the one- to eight-character ID for the virtual machine 
which is to receive suksequent VNET operator console 
output lines. 


Responses: 


CMTCMX560I VNET DISCONNECTING 
CMTCMX561E USERID ‘userid! NOT RECEIVING 


CRAIN 


The DRAIN command causes the specified link to be deactivated after the 
file currently being processed is completed. The lirk is deactivated 
immediately if no file is keing processed when the DRAIN command is 
issued. An inactive link is activated by a START command. If a START 
command is issued for the link kefore final file processing is complete, 
the link is not deactivated and normal procesSing is continued. The 
format for the DRAIN command is: 


ee 
| DRain | ({linkid] | 
L I a cn cone ana ae eee Oe | 
wheres 

linkid is the one- to eight-character link identifier for the 


link which is to ke deactivated. If the command is 
issued by the VNET operator, this operand must be 
specified; if issued from a remote station, it must be 
omitted. 


Responses: 


DMTxxx570I LINK ‘linkid' NOW SET TO DEACTIVATE 
DMTxxx571E LINK 'linkid*t ALREALY SET TO DEACTIVATE 


EXEC 


For VNET Operator Only 


The EXEC command executes a sequence of VNET commands which are 
contained within a CMS file on the VNET system disk. The format of the 
EXEC command i€ as follows: 


| EXec | filename 


u SSS Ch i “ED ED ED GREED OES 


98 VNET Reference and Orferations 


where: 


filename is the filename of a file containing one or more VNET 
commands to keé executed. The filetype of the file must 
be "'VNET', and the file must contain fixed length 80 
character records. 


VNET exec files may contain any valid VNET command except another EXEC 
command. Each line of the exec file is interfreted as a single VNET 
command line, and no conditionals or sukstitution variables are 
provided. 


At Initial Program Load, VNET will normally search its system disk for a 
file named ‘PROFILE VNET*, and will automatically execute the file as an 
exec file if it is found. This function may be suppressed by IPLing 
VNET using the 'NOPROF* parameter as follows: 


Ipl vaddr PARM NOPROF 


Responses: 


DMTCMX675E EXEC 'filename!t NCT FOUND ON CISK ‘'vaddr' -- COMMAND FILE 
NOT EXECUTED 

DMTCMX676E FATAL ERROR REACING FROM ‘vaddr'! -- EXFC 'filename' 
PROCESSING TERMINATED 

DMTCMX677E EXEC 'filename! FILE FORMAT INVALID -- EXEC NOT EXECUTED 

CMTCMX678E EXEC 'filename' IN EXECUTION -- NEW EXEC COMMAND IGNORED 

CMTREX679I EXECUTING 'filename* COMMAND: (command line) 


FLUSH 


The FLUSH command causes file processing to be halted for the file which 
is currently being transmitted on a link. The file is either purged or 
held, and link processing continues with the next file which is enqueued 
for transmission on the link. The format for the FLUSH command is: 


a ge a ee ng ee age Ee GS eg ee ee ee Es ye ee ee on 
| Flush | {linkid] [spoolid] { ALL|HO1d] | 
| | [ * ] | 
nn a a ae ae ee ee ee ——— Ee eee eed 
where; 

linkid is the one- to eight-character link identifier for the 


link on which the file to ke FLUSHed is being 
transmitted. If the command is issued by the VNET 
operator, this operand must be specified; if issued from 
a remote station, it must ke omitted. 


spoolid is the numeric spool file identifier for the file which 
is to ke flushed. This field is provided to assure that 
an operator does not inadvertently destroy the wrong file 
through a timing error. 


* the asterisk character (*) specifies that the current 
file being transmitted is to ke flushed. 
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Note: This option is only available to the remote 
operator. 


ALL is a keyword which signifies that all copies of the file 
being transmitted are to ke deleted. If this option is 
not specified, only the current copy is deleted and the 
next copy, if any, is processed. 


HCLD is a keyword which specifies that the file being 
transmitted is not to Le purged, Eut rather is to be 
saved and placed in system hold status. Processing of 
the file may ke restarted after the file has been taken 
out of hold status by means of the CHANGE command. 


Responses: 


DMTxxx580I FILE ‘spoolid'! PROCESSING TERMINATED 
DMTxxx581E FILE '‘spoolid' NOT ACTIVE 


FORCE 


For VNET Operator Only 


The FORCE command causes the immediate deactivation cf the specified 
link, and the termination of its line driver task. The format of the 
FORCE command is as follows: 


Ros ea ae a ee aa I RS SI aR SR 
| FORCE | linkid { 
t a Ee | 
where: 

linkid is the one- to eight-byte link identifier of the link to 


ke deactivated. 


The FORCE command should ke used only when the DRAIN command fails to 
deactivate the link. Note that the CRAIN command allows files in active 
transmission to complete kefore deactivation of the link. 


Responses: 
CMTREXOQ2T LINK 'linkid' CEACTIVATED 


FREE 


The FREE command causes file transmission for a particular link to ke 
resumed. The hold status for each of the files engqueued on the link is 
not affected. The FREE command has no effect on a link for which file 
transmission had not been previously suspended through the use of the 
HOLD command. The format for the FREE command is: 
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where: 


linkid is the one- to eight-byte link identifier for the link on 
which file transmission is to be resumed. If the command 
is issued Ly the VNET operator, this operand must be 
specified; if issued from a remote station, it must ke 
omitted. 


Responses; 
DMTxxx590I LINK 'linkid' RESUMING FILE TRANSFER 


DMTxxx591E LINK ‘linkid' NOT IN HOLD STATUS 
FWDS PACE 


The FWDSPACE command causes the current file being transmitted to be 
repositioned forward. The format of the FWDSPACE command is: 


Wie es be was eV fe ep ee OO et setae Bp wee ge eee OP TR ig se ae ge ga Sg gt eg ee 

| FWdspace [ [{linkid] [ nnn ] | 
ee | 

where: 

linkid is the one— to eight-—character link identifier for which 


the current file being transmitted is to be 
repositioned. If the command is issued by the VNET 
operator, this operand must be specified; if issued from 
a remote station, it must be omitted. 


nnn is the numker of data units to be forward spaced (if none 
is specified, a default of 1 is assumed). For a print 
file, data unit refers to printer pages, which are 
counted in the same way as for the VM/370 BACKSPAC 
command. For a punch file, data unit refers to file 
records which include any write type command code. If nn 
is greater than the number of data units remaining to ke 
processed, the command functions as a FLUSH command. 


NOTE: The nnn oferand is not supported by the DMTVMB, 
CMTVMC, or DMTNJI line drivers. 


Responses: 


DMTxxx600I FILE 'spoolid' FORWARD SPACED 
DMTxxx511E NO FILE ACTIVE ON LINK *linkid' 


HOLD 


The HOLD cemmand causes file transmission for a particular link to ke 
temporarily suspended, without deactivating the link. File transmission 
is suspended when the currently active file is completed, or, 
optionally, file transmicsion may be suspended immediately, and resumed 
from that point at a later time. The HOLD command does not affect the 
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hold status of any file engueued for transmission on the link. File 
transmission for the link may ke resumed by means of the FREE command. 
The format of the HOLD command is: 


Gg a eae ag et en ay eet Oe PT ee ge eg OE ee Gt Be TT a ty AIG Mp AUS ae Ee gm a ha ae ne ny ee oe 
| Hold {| [{linkid] [(IMMED] | 
Oa a a a a a a a a 
where: 

linkid is the one- to eight-byte link identifier of the link for 


which file transmission is to be suspended. If the 
command is issued by the VNET operator, this operand must 
be specified; if issued from a remote Station, it must be 
omitted. 


I MMED is a keyword which specifies that active file 
transmission, if any, is to be suspended immediately. 


NOTE: The IMMED operand is not supported by the DMTVMB, 
DMTVMC, or DMTNJI line drivers. 


DMTxxx61CI LINK ‘linkid' TO SUSPEND FILE TRANSMISSION 

CMTxxx611I LINK ‘linkid' FILE TRANSMISSION SUSPENDED 

DMTxxx612E LINK ‘linkid* ALREADY IN HOLD STATUS 

DMTxxx531I VALID COMMAND RECCGNIZED ON LINK 'linkid' -- NO 
ACTION TAKEN 


HT 


The HT ccmmrand suppresses the printing of any messages which are stacked 
for output to the VNET oferator console. The command has no effect on 
the execution of any other commands which may be in progress or 

pending. If entered from a remote station console, HT will purge any 
messages pending in that link's message stack. The format of the HT 
ccmmand is as follows: 


t= 


HT | | 


Responses: 


None. 
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MSG 


The MSG command causes a line of arbitrary text to be forwarded to a 
remote station and presented to a user or operator as a message. The 
format of the MSG command is: 


| Msg 


userid 


msgtext 


Responses: 


PMTxxx302E 
CMTxxx303F 
DMTCMX310E 
DMTxxx320E 
CMTRGX330F 
DMTRGX331E 
CMTRGX332E 


ORDER 


EE ee 


| locid userid [msgtext] 


is the one-— to eight—byte location identifier of the 
location which is to receive the specified text line. 
the message is for a local VM/370 user, this operand is 
specified as the local VNET location ID. 


is a one— to eight—byte identifier of a user at the 
specified lccation, or the identifier "'VNET' for the 
remote VNET operator console. If the message is to ke 
sent to a remote k-atch terminal the userid field will b 
ignored, tut a dummy entry must be included to avoid 
deletion of the first word of the message text. 


is an arbitrary string of alphameric characters 
comprising the message to be presented to the specified 
location and user. The maximum length of the character 
string is 120 characters. 


LINK tlinkid' IS NOT CEFINED 
LINK *linkid' IS NOT ACTIVE 
LOCATION Slocid* IS NOT DEFINED 
LINK tlinkid' NOT CONNECTEL 
USERIC MISSING OR INVALID 
"userid! NCT LOGGED ON 

fuserid' NOT RECFIVING 


The ORDER command causes the file queue for a particular link to be 
reordered as specified. The effect of the command is to redefine the 
order in which particular files are to ke processed on the link. The 
specified files are placed at the start of the link gueue in the 
specified order, and the file priority attribute is automatically set 
zero (top priority) for each specified file. The format of the ORDER 


command is: 


Cae 


| ORDer 


{| [linkid] {spoolid1 [ spoolid2 ... ]} 
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If 


S 


to 


ee 


i RE ee eee | 


03 


where: 


linkid is the one- to eight-byte link identifier for the link on 
which the file queue is to ke reordered. If the command 
is issued ky the VNET operator, this operand must be 
specified; if issued from a remote station, it must be 


omitted. 
spoolid1 specifies the affected file(s), and defines the new order 
ee in which they are to ke enqueued. 


Responses: 
DMTAXM523I LINK ‘linkid' QUEUE R FORDERED 


DMTAXM524EF FILE 'spoolid' ACTIVE -- NO ACTION TAKEN 

CYTAXM52SE FILE ‘spoolid' IS FOR LINK 'linkid' -- NO ACTION TAKEN 
CMTAXM526E FILE 'spoolid' NOT FOUND -- NO ACTION TAKEN 

PURGE 


The PURGE command causes specified inactive files for a particular link 
to ke removed from the system kefore they are processed on the link. 
Any file may be purged, regardless of its status, as long as it has not 
keen selected for transmission. The format of the PURGE command is: 


cr ee er Saw A ees ee eg ey ee Fe Sp eg Rags St ee 

| PURgE | <linkid] { ALL } 

| { spoolid1 spoolid2 ... } | 

L a cer oe ee a Ne a a ee eee 

where: 

linkid is the one- to eight-byte link identifier for the link on 
which the files to ke removed are engueuved. If the 
command is issued by the VNFT operator, this operand must 
be specified; if issued from a remote station, it must be 
omitted. 

ALL specifies that the entire queue of files for the link is 
to ke removed from the system. 

spoolidt specifies the particular file(s) to ke removed from the 

@#e oe s y S) te m e 


Responses: 


DMTAXM524E FILE 'spoolid' ACTIVE -- NO ACTION TAKEN 
CMTAXM525EF FILE ‘spoolid' IS FOR 'linkid' -- NO ACTION TAKEN 
DMTAXM526E FILE 'spoolid' NOT FOUND -- NO ACTION TAKEN 


DMTAXME40I 'nn! FILE(S) PURGED ON LINK ‘linkid' 


QUERY 


The QUERY command is used to display linkid, file, or system status 
information. If the command is issued by the VNET operator, the 
response is directed to the VNET virtual machine console. If the 
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cemmand is issued by a remote operator, the response is printed on the 
remote station printer. For the information returned by each option of 
the QUERY ccmmand, refer to the appropriate message text in "Appendix BE: 
VNET Message Summary." The format of the QUERY command is: 


Query 


fe ee ee ee ee se ee SS ee 4 


where: 


locid 


linkid ACTIVE 


DEF 


FILES 


QUEUE 


SUM 


8 ce Sg ee ee 


Poon! 


ona Woon Wena ttaan Yann’ 


CO PO FO pt FON oon Wann Wane Taos ann’ 


Only one item: a linkid, a file, or the system, may be queried at any 
one time, and only one keyword may ke specified. 


ae ee a a a Re ET I | 


REE COA EE cE <p ee EP EE ED A EE ed I 


| 

locid } | 
{ ACTIVE} } | 

linkid { DEF } } | 
{ FILES } } | 

{ QUEUE } } | 

{ SUN 3 } | 

c 1 } | 

| Stat | } | 

File spoolid | VM | } | 
[ VNET | } | 

: sj | 

SYstem [ Active ] } | 
{ Links ] } | 

[ Ports ] } | 

[ Queue ] } | 

[ Routes ] } | 

| 

| 


Se ny ee ee | 


requests information pertaining to the active 
attributes and status of the link specified by the 
one- to eight-character locid. (See the description 
of messages DMTCMX651I and DMTCMX6521.) 


requests information pertaining to the active file 
descriptors for the link specified by the one- to 
eight-character linkid. (See the description of 
messages DMTCMX656I and CMTCMX665I1.) 


requests information pertaining to the defined default 
attributes of the link specified by the one- to 
eight-character linkid. (See the description of 
message DMTCMX6531.) 


requests irformation pertaining to the file status of 
the link specified ky the one- to eight-character 
linkid. (See the description of message DMTCMX654T.) 


requests a list of brief descriptions of each inactive 
file enqueved for transmission, in the current queue 
order, on the link specified by the one- to eight- 
character linkid. (See the descriptions of messages 
DMTCMX654I and DMTCMX655I1.) 


requests information pertaining to the transaction and 
error counters maintained by the line driver 
concerning activity on the communications adapter. 
(See description of message DMTxxx149I.) 
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FILE spoolid STAT requests certain information pertaining to the 
particular file which is specified by the numeric 
Sspoolid. (See the descriptions of messages DMTCMX660I 
and DMTCMX661I.) 


VNET requests a description of the VNET control related 
attributes and status of the file specified Ly 
spoolid. (See the description of message DMTCMX662I1.) 


VM requests a description of the VM/370 spool system 
related attributes of the file specified by spoolid. 
(See the description of message DMTCMX66 31.) 


SYSTEM LINKS requests Erief descriptions of each link currently 
defined in the system. (See the descriptions of 
messages CMTCMX6701I, DMTCMX671I, and DMTCMX6731.) 


ACTIVE is a gualifier used with the SYSTEM keyword to request 
that only information pertaining to active links is to 
be listed. 

PORTS is a qualifier used with the SYSTEM keyword to request 


that a krief description of entries in the switchable 
port takle ke given. (See the descriptions of 
messages DMTCMX625I, DMTCMX6261I, and DMTCMX6271.) 


QUEUE is a qualifier used with the SYSTEM keyword to request 
that message DMTCMX654I be issued for each link with a 
non-zero queued or pending file ccunt. (See 
description of message DMTCMX654L and message 
DMTCMX674T.) 


ROUTES is a qualifier used with the SYSTEM keyword to request 
that a krief description of entries in the routing 


table ke given. (See the descriptions of messages 
DMTCMX634I and DMTCMX636I1.) 


Responses: 


QUERY ‘'locid'!: 

DMTCMX6361I ‘locid’ ROUTELC THROUGH LINK 'linkid' 

DMTCMX6371I tlocid! NCT ROUTEL 

CMTCMX6511I LINK tlinkid' INACTIVE 

CMTCMX6521I LINK 'linkid' (CONNECT | ACTIVE) 'task' 'type' ‘'vaddr' c 
(HO|NOH) (DR| NOL) (NCT [TRS | TRL|TSL) 

QUFRY tlinkid' ACTIVE: 

CMTCMX656I FILE 'Spoolid' (‘'orgid') ‘locid' ‘tuserid' CL a PR pp 
LEFT mmmmmmmm OF nnnnnnnn 

DMTCMX665I NO FILE ACTIVE 

QUFRY 'linkid' DEF: 


CMTCMX653I LINK *linkid' CEFAULT 'task! ‘'typet ‘vaddr' c Z=z R=r 
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QUERY *linkid*® FILES: 


CMTCMX6541I LINK ‘linkid' S=s R=r Q=q P=p 


QUERY 'linkid' QUEUE: 

DMTCMX654I LINK ‘linkid' S=s R=r Q=q P=p 

DMTCMX655I FILE 'spoolid! ('orgid') ‘locid' ‘userid' CL a PR pp 
REC nnnnnnnn (HO| NOH) 

QUERY ‘linkid' SUM: 

CMTCMX149I LINK "linkid' LINE ACTIVITY; TOT=mmmmmmmn; 

ERRS=nnnnnnnn; TMOUTS=pprprppp 

QUERY FILE 'spoolid' STAT: 

CMTCMX6601I FILE 'spoolid! INACTIVE ON LINK 'linkid' 

CMTCMX661I FILE ‘tspoolid’ ACTIVE ON LINK 'linkid' 

DMTCMX664E FILE "spoolid' NOT FOUND 

QUERY FILE ‘'spoolid’ VM: 

CMTCMX6631I FILE "spoolid' PR pp CL a CO nn (HO|NOH) CI 'distcode', 
NA (‘fn ft'|'dsname') 

DMTCMX664E FILE 'spoolid' NOT FOUND 

QUERY FILE 'spoolid' VNET: 

CMTCMX662I FILE *spoolid! ORG ‘lccid1* ‘userid1' ORGID ‘orgid' 
mm/dd/yy hh:mr:ss z.z.ez. 10 tlocid2' ‘userid2' 

DMTCMX664E FILE 'spoolid! NOT FOUND 

QUERY SYSTEM ACTIVE: 

CMTCMX670I LINK *tlinkid' (CONNECT|ACTIVE) -- LINE ‘vaddr' (HO| NOH) 
(DR(NOD) (NOT|IERS|TRL{TSL) 

CMTCMX672I NO LINK ACTIVE 

QUERY SYSTEM LINKS: 

CMTCMX670I LINK ‘linkid' (CONNECT|ACTIVE) -- LINE 'vaddr' (HO| NOH) 
(DR| NOD) (NOT|TES[TRL|TSL) 

CMTCMX671I LINK tlinkid' INACTIVE 

DMTCMX6731I NO LINK DEFINED 

QUERY SYSTEM PORTS: 

DMTCMX625I NO PORTS AVAILAELE 

DMTCMX6261I PORT 'vaddr' AVAILABLE 

CMTCMX627I PORT 'vaddr' IN USE BY LINK 'linkid' 

QUERY SYSTEM ROUTES: 

DMTCMX634I NO LOCATIONS ROUTED 

DMTCMX636I tlocid' ROUTECL TRROUGH LINK 'linkid' 
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QUERY SYSTEM QUEUE: 


CMTCMX6541I LINK !linkid' S=s R=r Q=q P=p 
CMTCMX674TI NO FILES QUEUED 


REORDER 


For VNET Operator Only 


The REORDER command causes all inactive files currently owned by the 
VNET virtual machine to ke reaccepted and routed. REORDER is not 
normally issued by the VNET cperator, but is issued internally by VNET 
during processing of CLOSE, DEFINE, DFLETE, ROUTE, or START commands, 
and following any link deactivation. The format of the REORDER command 
is: 


ee a ee ee 
| REORDer | | 
Sa i ere Sn ee ee 


(Execution of this command will never adversely affect VNET operations. 

However, in case of abnormal occurrences, files presented to VNET might 

not ke immediately accepted and transmitted automatically. Execution of 
the REORDER command forces VNET to inspect its input files, and can have 
the effect of initiating transmission of a ‘hung! file.) 


Responses: 
DMTAXM109I FILE QUEUE REORCDERED 


ROUTE 


For VNET Operator Only 


The ROUTE command defines, mcdifies, or deletes an entry in the VNET 
routing takle. The VNET routing table is used by VNET to automatically 
determine which link is to receive files, commands, and messages which 
cannot be transmitted to their destination location on a direct link. A 
direct link and an indirect route may be concurrently defined for the 
same remote location, uSing a Single locid. In this case, indirect 
routing is automatically used only when the indirect link is active and 
the direct link is not. Files are automatically reenqueued following 
execution of a ROUTE command, so that transmission of rerouted files can 
begin immediately. The fcrmat of the ROUTE command is as follows: 


| 
| | {OFF } | 
a 


locid is the one- to eight-character identifier for the 
location whose routine is to be modified. 
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TO linkid specifies the link through which files, commands, and 
messages addressed to the specified remote location 
are to ke routed. 


OFF cancels indirect routing for the specified locid. 


Responses: 


DMTCMX630I ‘locid' NOW ROUTED THROUGH LINK 'linkid' 

DMTCMX631I INDIRECT ROUTING FOR ‘'locid' DEACTIVATED 

DMTCMX632E ‘locid' INVALIC ROUTE SPECIFIED 

DMTCMX633E ‘locid' NOT ROUTEL -- ROUTE LIMIT REACHED 

DMTCMX638EF LOCATION ‘locid' HAS A FILE QUEUE -- 
INDIRECT ROUTING NOT CEACTIVATED 


SHUTDOWN 


For VNET Operator Only 


The SHUTDOWN command effectively issues a DRAIN command to each link 
which is currently active. This function provides a convenient means 
for gracefully terminating VNET operations. The format of the SHUTDOWN 
ccmmand is: 


(eo aye is 
| SHUTDOWN = | | 
Sa a a 


Responses: 


See responses to the DRAIN command. 


START 


The START command, issued ky the VNET operator, can cause a specified 
inactive link to be activated. It can also be used by either the VNET 
or remote operator to cause a particular active link to begin processing 
files of a specified set of classes or to reset a pending deactivation 
due to a DRAIN command. The format of the START command is: 


= 
| | ; 

| STArt | linkid | cCLass c | {[Parm ... ] 
| | [ LINE vaddr ( 

| | TASK name | 

| | | TYPE driverid | 

| | t J 

| 


| Any combination of keywords with associated options may be entered 

| in any order, except that Parm keyword must be the rightmost keyword, 
| if it is entered. 
t 


| 
| 
| 
| 
| 
| 
| 
| 
| 


a ee a ne newman 
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where: 


linkid 


CLASS c 


LINE vaddr 


TASK name 


TYPE driverid 


PARM 


is the one- to eight-character link identifier for the 
inactive link to ke activated, or for the active link on 
which file processing is to be altered. If the command 
is issued by the VNET operator, this operand must be 
specified; if issued from a remote station, it must be 
omitted. 


specifies classes of files which may be processed 
subsequent to the command execution. c can be either *, 
meaning all file classes may be processed, or from one to 
four classes (single characters with no intervening 
blanks). If * is specified, no other classes may be 
specified. If multiple classes are specified for a link, 
files are processed in the order that the classes were 
specified, and in priority order within each particular 
class. If * is specified, files are processed in 
priority sequence, only. If no classes are specified, 
the definition of CLASS in the link's link table is 

used. 


designates the virtual device address (vaddr) of the line 
port which is to ke used ky the newly activated link. 

The value specified overrides a device address which may 
have been previously defined for the link. If no line 
port address is specified, the previously defined address 
is used. If no address was previously defined and no 
address is specified, an available switched port is 
selected for use, and the operator is informed of that 
selection. This keyword option is valid only when 
activatino an active link. 


designates a task name for use by the line driver to be 
initialized, which overrides the name which may have been 
previously defined for the link. name is a one- to 
four-character alphameric identifier. If this field is 
not specified, the name previously defined for the link 
is used. If no name was previously defined for the link, 
an appropriate descriptive default task name is generated 
and used. This keyword option is valid only when 
activatine an active link. 


designates the name of the line driver which is to be 
used for the link to ke activated. driverid is a one- to 
e€ight-character name of the line driver to be used with 
the newly activated link and must have been defined 
during VNET generation. This keyword option is valid 
only when activating an active link. See the section in 
this document on line driver selection for determining 
which line driver to use for a given application. This 
specification overrides the driver name which may have 
been previously defined for the link. 


Note: If no line driver type was previously defined for 
the link, this field must be specified. 


is a keyword which causes the remainder of the command 
line to the right of the PARM keyword to be made 
available to the newly activated line driver. No further 
interpretation is performed on the command line after a 
PARM keyword is encountered, so it must always be the 
rightmost keyword to be specified. For a description of 
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the PARM operands for each line driver, see the section 
on the START command in the description of each line 
driver. 


Responses: 


DMTCMX700I ACTIVATING LINK ‘linkid' ‘'task' 'type' ‘vaddr' c 


DMTCMX701E NO SWITCHED LINE AVAILABLE -- LINK ‘'linkid' NOT ACTIVATED 
DMTCMX702E LINE ‘vaddr' IS IN USE BY LINK "linkid1' -- LINK 'linkid2' 
NOT ACTIVATED 
DMTCMX703E DEV ‘fcuut IS NOT A LINE PORT -- LINK 'linkid! NOT ACTIVATED 
DMTCMX704E LINE ‘vaddr' Cc=3 NOT OPERATIONAL -- LINK 'linkid' 
NOT ACTIVATED 
DMTCMX705E DRIVER 'type' NOT FOUND ON DISK 'vaddr' -- LINK 'linkid' 
NOT ACTIVATED 
DMTCMX706E FATAL ERROR LOADING FROM 'vaddr' -- LINK 'linkid' 
NOT ACTIVATED 
DMTCMX7O07E DRIVER 'typet FILE FORMAT INVALID -- LINK ‘'linkid' 
NOT ACTIVATED 
DMTCMX708E VIRTUAL STORAGE CAPACITY EXCEEDED -- LINK 'linkid' 
NOT ACTIVATED 
DMTCMX709E TASK NAME 'task* ALREADY IN USE -- LINK 'linkid' 
NOT ACTIVATED 
DMTCMX#10E MAX ('nn') ACTIVE -- LINK 'linkid' NOT ACTIVATED 
DMTxxx750E LINK 'linkid' ALREADY ACTIVE -- NO ACTION TAKEN 
DMTCMX751I LINK *linkid' ALREADY ACTIVE -- NEW CLASS (ES) SET AS REQUESTED 
DMTxxx752I LINK ‘linkid' STILL ACTIVE -- DRAIN STATUS RESET 
DMTSMLI90O01E INVALID SML MOLE SPECIFIED -- LINK 'linkid' NOT ACTIVATED 
DMTSML9O6E INVALID SML BUFFER PARAMETER ~-- LINK 'linkid' NOT ACTIVATED 
CMTNIT911E INVALID NJI BUFFER SIZE SPECIFIED -- LINK ‘linkid' 
NOT ACTIVATED 
DMTNIT912E INVALID NJI NODAL RESISTANCE SPECIFIED -- LINK 'linkid' 
NOT ACTIVATED 
DMTNIT913E INVALID PASSWORD PARAMETER SPECIFIED -- LINK 'linkid' 


NOT ACTIVATED 


TRACE 


For VNET Operator Only 


The TRACE command causes the specified active link to report certain 
line activity information on the operator console, or to cease reporting 
such information. (See the description of the message DMTxxx149I in 
"VNET Message Summary".) The purpose of this function is to provide 
operator assurance that the line service is functioning properly, and to 
generate documentation to ke used in problem determination. The format 
of the TRACE command is: 


5 a SSR SS aS SESS EE 


SSSI OEE RD ORR NG AEE: ER) EEE SESE ES ESRC ES SS A A 


eee 


—_ 
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where: 


linkid is the one- to eight-byte link identifier of the link for 
which activity tracing is to be initiated or terminated. 


SUM is a keyword which specifies that the link's line driver 
is to report all line activity in a standard format. 


NOSUM is a keyword which specifies that the link's line driver 
is to cease reporting line activity. This is the initial 
state on system start-up. 


LOG is the keyword that starts the logging of I/O activity on 
the link. 
NOLOG is the keyword that stops the logging of I/O activity and 


initiates the automatic printout of the log data. fhis 
is the initial state on system Start-up. 


Responses; 


DMTxxx149I LINK *'linkid' LINE ACTIVITY; TOT=mmmmmmmm; 
Errs=nnnnnnnn; TMOUTS=pppppppp 

DMTxxx801I LINK "linkid' LOG ACTIVATED 

DMTxxx802I LINK 'linkid' LOG DEACTIVATED 

DMTxxx803I LINK ‘linkid' SUM REPORTING DEACTIVATED 

DMTxxx810E LINK 'linkid' LOG ALREADY ACTIVE 

DMTxxx811E LINK 'linkid' LOG NOT ACTIVE 

DMTxxx812E LINK 'linkid' SUM REPORTING ALREADY ACTIVE 

DMTxxx813E LINK ‘linkid' SUM REPORTING NOT ACTIVE 


TRANSFER 


For VNET Operator Only 


The TRANSFER command redirects inactive files specified by '‘spoolid' to 
a new destination. VNET removes the files from ‘linkid' and enqueues 
them on the link associated with the path to the new ‘locid'. 


Cy oo ates ost FN ta ee Pe Ea BO Ny ge ENT Fg oe ee ee Ly See ete eee Seg aC ee Np ee re re eee 
| TRANSfer | [{linkid] spoolid1 spoolid2 ... TO locid [userid] | 


ee a eee eee ee ee ee eee 
where: 
linkid is the one- to eight-byte link identifier of the link 


from which files are to be transferred. 


spoolid1 specifies the particular file(s) to be transferred from 
the specified link. 


locid is the one- to eight-by:e location identifier of the new 
destination for the specified spoolids. 


userid is a one- to eight-byte identifier specifying the new 


destination userid for the specified spoolids. This 
userid will default to 'system' if not specified. 
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Responses: 


DMTAXM524E FILE 'spoolid' ACTIVE -- NO ACTION TAKEN 
DMNTAXM525E FILE ‘spoolid' IS FOR LINK *linkid' -- NO ACTION TAKEN 
DMTAXM526E FILE 'spoolid!' NOT FOUND -- NO ACTION TAKEN 


DMTAXM645I 'nn' FILE(S) TRANSFERRED ON LINK 'linkid! 
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APPENDIX B: VNET MESSAGES 


Appendix B contains a detailed description of the VNET messages and wait 
state codes. A message summary is included that groups the messages 
according to the type of operation in progress at the time of message 
generation. 


VNET messages are issued in response to commands and spontaneously 
during system execution. Messages, in response to commands, are issued 
to the command originator and, in certain cases, to the VNET local 
operator. Spontaneous messages are issued to the VNET local operator 
whenever error or informational conditions arise during system 
operation. Certain Spontaneous messages are issued to virtual machine 
users when they apply to files originated or destined for the users. 


MESSAGE FORMAT 


The message codes listed conform to VM/370 standards. The first three 
characters (DMT) denote the VNET component of VM/370. The next three 
characters denote the module origin of each message; the possible codes 
are REX, RGX, CMX, AXM, INI, IRX, NPT, SML, VMB, VMC, NCM, NHD, and 
NIT. Some messages can Ee issued by more than one module. The next 
three characters contain the message number. The last character is a 
message severity code and consists of the following: 


response messSage 

informational message 

error message 

terminal error -- system shutdown ' 
severe error message 


nee a 


The message code (DMTAXM101I for example) is included in the message 
line if the "ON" option of the CP command "EMSG" is chosen. Time, in 
the format of "hh:mm:ss", appears at the start of the message line. 
This is the time the message was generated. 


MESSAGE CESCRIPTIONS 


DMTAXM101I FILE 'spoolid' ("'orgid') ENQUEUED ON LINK 'linkid' 


Explanation: This message is issued when the file identified 
by ‘spoolid', origin spoolid ‘torgid', has arrived at the VNET 
virtual machine, and has keen successfully accepted and 
enqueued on the link identified by ‘linkid'. This message is 
also issued when a previously pending file is accepted after 
a tag slot has ktecome available. 


System Action: The newly accepted file is made available to 
the link's line driver for future transmission. If the line 

. driver is waiting for a file to transmit, it is notified that 
the new file is available. 


Operator Action: None. 
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FILE 'spoolid! ("orgid') PENDING FOR LINK 'linkid' 


Explanation: The file identified by 'spoolid', origin spoolid 
‘orgid', has arrived at the VNET virtual machine, but has not 
been enqueued on the link ‘'linkid' to which it is addressed, 
because no tag slot is available. 


System Action: The link's pending count is incremented, and 
the file will be automatically accepted when a tag slot 
becomes availatle. 


Operator Action: If VNET repeatedly exhausts its available 
tag slots in normal operation, more extra tag slots should be 
generated using the ‘'TAGS' directory control statement, or by 
increasing the VNET virtual machine's virtual storage Size. 


FILE *spoolid!' ('orgid') REJECTED -- INVALID DESTINATION 
ADDRESS 


Explanation: The file identified by '‘spoolid' origin spoolid 
forgid' has arrived at the VNET virtual machine bearing a 
destination address which is invalid, or which specifies a 
location ID that is not defined in the local VNET system as 
either a link or an indirect route. 


System Action: If the file originated from a local VM/370 
user, it is transferred back to the originator along with 
this message. If the file originated at a remote location, 
it is purged and this message is sent to the originator. 


User Action: If the file is transferred back from VNET, the 
tag on the file to be transmitted may be corrected using the 
VM/370 ‘TAG FILE ‘spoolid'* command to reflect a correct 
destination, and the file may then be transferred back to the 
VNET virtual machine using the VM/370 "TRANSFER 'spoolid' TO 
'ymid'* command. If the file is purged because it arrives at 
a location which does not have the destination location ID 
defined, the situation should be reported to local VNET 
system support personnel. 


FILE (‘orgid') SPOOLELD TO tuserid1' -=- ORG ‘'locid' 
("‘userid2') mm/dd/yy hh:mm:ss 


Explanation: A file has been received from a remote location, 
acknowledged, written to the VM/370 spool system, closed, and 
spooled to the local virtual machine to which the file was 
addressed. 


orgid - the originating VM/370 spool ID, or the origin job 
number, of the file. 

userid1 - the ID of the local virtual machine to which the 
file has been spooled. 

locid - the location identifier of the file's originator. 

userid2 - the name of the file oriqinator's system or device 


at the remote location. 

mm/dd/yy - the date of the file's origination at the remote 
location. 

hh:mm:ss - the time of day of the file's origination at the 
remote location. 


System Action: The virtual output device used to process the 
file is detached and normal processing continues. 


Reference and Operations 


DMTAXM105TI 


DMTAXM1061 
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Operator Action: None. 


FILE ‘'spoolid' PURGED 


Explanation: The file identified by ‘spoolid' has been purged 
from the system as a result of normal processing. 


System Action: The file's virtual storage tag is dequeued and 
its slot is freed. If another file is pending, it is 
accepted. All system tables are updated, and normal 
processing continues. 


Operator Action: None. 


FILE 'spoolid' MISSING -- DEQUEUED FROM LINK ‘linkid!' 


Explanation: The file identified by 'spoolid' could not be 
located in the VNET virtual machine spool input file queue 
during an attempt to open the file for the link identified by 
'linkid'. This situation can arise when a user retrieves a 
file from the the VNET spool queue using the VM/370 ‘TRANSFER 
"spoolid' FROM 'vmid'* command. 


System Action: The file's virtual storage tag is dequeued and 
its slot is freed. If another file is pending, it is 
accepted. The link table entry is updated, and normal 
processing continues. 


Operator Action: No action is necessary. This message does 
not indicate an error condition. 


'nn' PENDING FILES FOR LINK 'linkid! MISSING 


Explanation: A number ('nn') of pending files for the link 
identified by ‘linkid't have been found to be missing from the 


VNET virtual machine spool input queue during an attempt to 


accept a pending file. This situation can arise when a user 
retrieves a file from the VNET Spool queue uSing the VM/370 
"TRANSFER 'spoolid* FROM 'vmid'' command. 


System Action: The link table entry is updated to reflect the 
proper pending file status, and normal processing continues. 


Operator Action: No action is necessary. This message does 
not indicate an error condition. 


FILE QUEUE REORLTEREDL 

Explanation: As the result of a VNET CLOSE, DEFINE, DELETE, 
REORD, ROUTE, or START command, or as the result of a link 
deactivation, the inactive file queue has been reordered to 
reflect the updated status of the VNET system. 


System Action: Each file enqueued by VNET is re-examined and, 
if appropriate, rerouted in light of changed system status. 


Operator Action: None. 
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DMTAXM5201 


118 VNET 


USER ‘userid' NOT IN CP DIRECTORY -- FILE (‘orgid') SPOOLED 
TO SYSTEM 


Explanation: A file received by VNET was addressed to a local 
user tuserid' which is not in the local VM/370 system 
directory. The file had an origin spool ID of ‘orgid'. 


System Action: The received file is spooled to a real unit 
record device at the receiving location. 


Operator Action: None. 


'nn' FILE(S) CLOSED ON LINK ‘linkid! 


Explanation: A number of files denoted by ‘nn! that were 
active on the inactive link identified by 'linkid' have been 
deactivated either in response to a VNET CLOSE command, or as 
an automatic result of link deactivation. 


System Action: Previously active input files are reenqueued 
for complete retransmission. Previously active output files 
are normally incomplete, and are therefore purged. 


Operator Action: None. 


LINK *linkid' ACTIVE -- NO FILE(S) CLOSED 


Explanation: The VNET operator attempted to issue a CLOSE 
command to an active link specified by 'linkid'. 


System Action: CLOSE command processing is suppressed and 
file status remains unchanged. 


Operator Action: The command may be reissued after the link 
has been deactivated. 


FILF "spoolid' INACTIVE -- NO ACTION TAKEN 


Fxplanation: The file identified by ‘spoolid' is already 
inactive. The action requested by the preceding command 
could not be performed. 


System Action: The preceding command has no effect, and 
norwal processing continues. 


Operator Action: Verify the spool file ID used in the 
preceding command. If it was incorrect, the command may be 
retried with a corrected spool file ID. If it was correct, 
and the file is inactive, the preceding command was not valid 
for inactive files. 


FILE 'spoolid' CHANGED 


Explanation: The file identified by 'spoolid' has been 
altered as requested in the processing of the preceding 
command. The new file status remains in effect until it is 
changed again through operator command processing. 


System Action: All appropriate action implied by the change 


of status is performed. This might include reordering a link 
queue if a file priority was changed, notifying a waiting 


Reference and Operations 


DMTAXM52 1I 


DMTAXM522T 


DMTAXM5231 


DMTAXM52 4E 


line driver if a file class was changed, and so on. Normal 
VNET processing continues. 


Operator Action: None. 


FILE 'spoolid' HELD FOR LINK 'linkid' 


Explanation: The file identified by ‘spoolid' has been placed 
in hold status as the result of processing of the preceding 
command. 


The file will ke kept in hold status and will not be 
transmitted until it is removed from hold status by command 
processing. 


Operator Action: None. 


FILE 'spoolid' RELEASED FOR LINK 'linkid' 


Explanation: The file identified by 'spoolid' and enqueued on 
the link identified by ‘linkid' has been released from hold 
status as a result of the processing of the preceding 
command. The file is now eligible for transmission on the 
link. 


System Action: The released file will be selected for 
transmission according to the normal rules of file priority. 
The link's line driver is asynchronously notified of the 
file's availability for transmission if the line driver had 
been waiting for a file to transmit. Normal VNET processing 
continues. 


Operator Action: None. 


LINK *linkid' QUEUE REORDFRED 


Explanation: The file tag queue in VNET virtual storage for 
the link identified by ‘linkid' has been reordered in 
response to execution of a command. The new order of the 
queue represents the order of file transmission for the 
link. 


System Action: The files reordered to the beginning of the 
queue are automatically given a priority of zero (highest), 
and normal processing continues. 


Operator Action: None. 


FILE *spoolid' ACTIVE -- NO ACTION TAKEN 


Explanation: The file identified by 'spoolid' is actively 
being read and transmitted on a link, and the action 
requested in the preceding command cannot be performed on 
active files. 


System Action: The preceding command has no effect, and 
normal processing continues. 


Operator Action: If desired, the file may be deactivated by 


means of a VNET 'FLUSH.'linkid'* "spoolid' HOLD' command, and 
the preceding command may then be retried. 
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DMTAXM525E FILE 'spoolid' IS FOR LINK 'linkid' -- NO ACTION TAKEN 


DETAXM526E 


DMTAXM640I 
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Explanation: The file identified by ‘spoolid' is enqueued on 
the link identified by 'linkid', which is different from the 
linkid specified in the preceding command. 


System Action: The action requested in the preceding ccmmand 
is not performed, and normal processing continues. 


Operator Action: Verify that the specified spool file ID and 
link ID are correct. If an error is found, retry the 
preceding comrard. 


FILE 'spoolid' NOT FOUND -- NO ACTION TAKEN 


Explanation: The file identified by ‘spoolid' which was 
Specified in the preceding command is not owned by VNET, or 
is pending. A 


System Action: The preceding command has no effect, and 
nornal processing continues. 


Operator Action: Verify the spool file ID used in the 
preceding command. If it was incorrect, the command may be 
retried with a corrected spool file ID. If it was correct, 
and the file is pending at the VNET virtual machine, the file 
may be manipulated through the use of VM/370 CP spooling 
commands. 


‘nn! FILE(S) PURGED ON LINK ‘linkid' 


Explanation: The number of files denoted by 'nn*' which were 
enqueued on the link specified by ‘linkid' have been purged , 
from the system in response to a PURGE command. 


System Action: The files' virtual storage tags are dequeued 
and the tag slots are released. Pending files for the link 
are accepted if a sufficiently large number of free tag slots 
results. 


Operator Action: None. 


‘nn! FILE(S) TRANSFERRED ON LINK *linkid' 


Explanation: The number of files denoted by ‘nn which were 
enqueued on the link specified by 'tlinkid' have been 
re-addressed to a new destination in response to a TRANSFER 
command. 


System Action: The destination address for the file or files 

is permanently changed, and the files are reenqueuved to their 

new destination Ly a file queue reorder which is - 
automatically performed by TRANSFER command processing. 


Operator Action: None. 
FREE STORAGE = ‘'nnt PAGES 


Explanation: This message is issued automatically when the 
number of pages of unallocated virtual storage available to ) 
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VNET increases or decreases by a certain increment. The new 
number of available free pages is denoted by ‘nn’. 


System Action: Normal VNET processing continues. 


Operator Action: This information is intended to help the 
operator understand the state of VNET system processing. 
Knowledge of virtual storage utilization helps the operator 
to decide whether to activate or deactivate links, and allows 
the system programmer to decide an apfropriate virtual 
storage size for the VNET virtual machine. 


LINK *linkid* EXECUTING: (command line text) 


Explanation: The VNET command described by (command line 
text) has been forwarded Ly a directly connected remote 
Station for execution by the local VNET system. The link 
identifier of the originating remote station is specified by 
"linkid'. 


System Action: The command is executed, and the resulting 
response is automatically returned to the originating remote 
station. 


Operator Action: None. 


LOCATION tlocid! EXECUTING: (command line text) 


Fxplanation: The VNET command described by (command line 
text) has been forwarded by the network operator at a remote 
location for local execution. The location identifier for 
the originating remote location is identified by ‘'locid'. 


System Action: The command is executed, and the resulting 
response is automatically returned to the originating remote 
network operator. 


Operator Action: None. 


LOCATION tlocid'(tuserid') EXECUTING: (command line text) 


Explanation: The VNET command descriked by (command line 
text) has been forwarded by a interactive user at a remote 
location for execution by the local VNET system. The command 
originator's location and user identifiers are specified by 
'locid! ('userid'), respectively. 

System Action: The command is executed if it is a valid 
command for user execution, and the resulting response is 
autcmatically returned to the originating remote interactive 
user. 


Operator Action: None. 


VNET 


Fxplanation: This message is issued in response to a null 
line entered as a VNET command. A null line is a line that 
contains no characters. 
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System Action: If a command which is entered from a VNET 
operator console contains no characters as the result of 
console input line editing, this message is not issued and 
another console read is automatically started. Normal VNET 
processing continues. 


Operator Action: None. 


INVALID COMMAND ‘command ' 


Explanation: The character string identified by "command! was 
entered as a VNET command. The command either is prohibited 
for use by the command originator, or is not a defined VNET 
command. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: The command may ke retried if it was entered 
in error. 


INVALID LINK *linkid' 


Explanation: The character string identified by ‘linkid' was 
entered as a VNET link ID in a console command input string, 
and it does not conform to syntactical reguirements for VNET 
link IDs. (It is not one to eight alphanumeric characters.) 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: The command may Le retried if it was entered 
in error. 


INVALID SPOOL IC 'srfoolid' 


Explanation: The character string identified by 'spoolid' was 
entered as a spool file ID in a console ccmmand input string, 
and it does net conform to syntactical requirements for 
VM/370 spool file IDs (one to four decimal digits, 1-9900). 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: The command may be retried if it was entered 
in error. 

INVALID KEYWORD ‘keyword’ 

Explanation: The character string identified by 'keyword' was 
entered as a keyword in a console command input string, and 


it is not a valid keyword for the command issued. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: VNET command documentation should be 


consulted to determine command syntax and restrictions. The 
command may ke retried if it was entered in error. 
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CONFLICTING KEYWORD 'keyword' 


Explanation: The keyword identified by ‘keyword’ was used in 
the preceding ccmnmand in an invalid way. The keyword may 
have been entered more than once in the same command line, or 
the keyword may be invalid because another mutually exclusive 
keyword was entered in the same command. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: VNET command documentation should be 
consulted to determine command syntax and restrictions. The 
command may ke retried if it was entered in error. 


INVALID OPTION ‘keyword! ‘option! 


Explanation: The combination of a keyword and its option 
identified by ‘keyword! ‘option’ was entered ina console 
command line, and it is not a valid combination for the 
command issued. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: VNET command documentation should be 
consulted to determine command syntax and restrictions. The 
comrand may ke retried if it was entered in error. 


CONFLICTING OPTION ‘keyword! ‘option! 


Explanation: The combination of a keyword and its option 
identified by "keyword! ‘option' was used in the preceding 
command in an invalid way. The presence of another keyword 
or keyword-and-cption combination in the same command may 
preclude specification of the identified keyword-and-option 
comkination. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: VNET command documentation should be 
consulted to determine command syntax and restrictions. The 
command may ke retried if it was entered in error. 


INVALID USER IC ‘userid! 


Explanation: The operand identified by ‘userid' was entered 
in a VNET command as an interactive user ID, and is invalid 
as such. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Valid interactive user IDs contain one to 


eight nonblank valid EBCDIC characters. The preceding 
command may Le retried if it was entered in error. 
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RESTRICTED COMMAND ‘command! 


Explanation: An attempt was made to execute the command 
identified ky ‘command! which is not authorized for execution 
by the originating remote operator or user. 


System Action: The command has no effect, and normal VNET 
processing continues. 


Qperator Action: The command may ke retried if it was entered 
in error. Questions concerning authorization for command 
execution should be directed to those responsible for VNET 
system support. The VNET operator may be directly contacted 
for any special line, file, or routing requests. 


INVALID LOCATION ‘locid' 


Explanation: A previously entered command specified as its 
object a location IL identified by ‘locid' which was not 
valid. The invalid location ID may have contained more that 
eight characters, or may have contained no characters at 
all. 


System Action: The command is ignored, and normal VNET 
processing continues. 


Qperator Action: The command may be retried if it was entered 
in error. 


LOCATION ‘locid! IS NOT DEFINED 


Explanation: 


A previously entered command specified as its object a 
location ID identified by ‘locid' which was valid, but which 
was not defined as a direct link or an indirect route at the 
time of command processing. 


System Action: The command is ignored, and normal VNET 
processing continues. 


Operator Action: The command may ke retried if it was entered 
in error. A CEFINE command may be executed to temporarily 
define a new link, or a ROUTE command may be executed to 
temporarily define a new indirectly routed location. 
Corresponding LINK and ROUTE entries should be made to the 
VNET DIRECT file for permanent directory definitions. 


NEW LINK ‘linkid' DEFINED 


Explanation: The link identified by 'linkid' is now defined 
as the result of VNET DEFINE command processing. Attributes 
of the newly defined link are determined by the specified and 
default DEFINE command options. 


System Action: The VNET file queue is automatically 
reordered. Files may be automatically enqueued on the newly 
defined link. The new link definition will remain in effect 
until the VNET system is restarted, or until it is removed ky 
a VNET DELETE command. 
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Operator Action: Users may begin addressing files, ccmmands, 
and messages to the newly defined link. A LINK statement 
defining the new link must be added to the VNET directory to 
cause the link to ke defined after a VNET system restart. 


LINK 'linkid' REDEFINED 


Explanation: The previously defined link, identified by 
'linkid', has had its definition changed as the result of 
command processing, according to the specified keyword 
options. 


System Action: The changes in the link definition become 
effective immediately. 


Operator Action: None. 


LINK *tlinkid' ACTIVE -- NOT REDEFINED 


Explanation: The previously defined link, identified by 
‘linkid', has not been redefined because the link was active 
at the time of command processing. 


System Action: The command execution is terminated, the 
command has no effect, and normal processing continues. 


Operator Action: The command may be retried successfully 
after the link has been deactivated. 


LINK tlinkid' NOT DEFINED -- LINK LIMIT REACHED 


Explanation: An attempt was made to define a new link, but 
the maximum allowable number of defined links had already 
been reached. 


System Action: The command execution is terminated, the 
command has no effect, and normal processing continues. 


Operator Action: Check the command line to see if it was 
accurately typed. If an existing link definition was to have 
keen altered, retry the command with a corrected command 
line. If a new link was to ke defined, another link must be 
temporarily removed from the VNET system by means of the VNET 
DFLETE command before the command can be successfully 
retried. 


LINK tlinkid' NOW DELETED 


Explanation: The previously defined link, identified by 
'linkid', is now temporarily deleted as a result of VNET 
DELETE command processing. 


System Action: Spool files addressed to the deleted link's 
location ID are no longer accepted, and are rejected as 
invalidly addressed. Such files may be returned to local 
originating users, or are purged if they are not of local 
origin. The deleted link can no longer be activated. 


Operator Action: Files, commands, and messages can no longer 
ke handled through the previously defined link. 
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LINK 'linkid' ACTIVE -- NOT DFLETED 


Explanation: An attempt was made to temporarily delete the 
link identified by ‘linkid' from the VNET system by the VNET 
DFLETE command. The attempt was unsuccessful because the 
specified link was active at the time of command processing. 


System Action: The link remains defined and active, the 
command has no effect, and normal processing continues. 


Operator Action: The command may be successfully retried when 
the link has been deactivated. 


LINK ‘linkid' HAS A FILE QUEUE -- NOT CELETED 


Explanation: An attempt was made to temporarily delete the 
link identified by ‘linkid' Ly a VNET DELETE command. The 
attempt was unsuccessful because the specified link had at 
least one file enqueued on it at the time of command 
processing. 


System Action: The link remains defined, the command has no 
effect, and normal processing continues. 


Operator Action: Pefore the link can ke deleted, all files 
enqueued on it and pending for it must be purged, either by 
console command execution ocr through normal file 
transmission. 


VNET DISCONNECTING 


Explanation: The VNET virtual machine console is disconnected 
aS a result of command execution. If an alternate virtual 
machine was specified to receive VNET output messages, that 
virtual machine will kegin receiving the console messages 
through the VM/370 MSG function. 


System Action: VNET continues processing normally without a 
main operator console. 


Operator Action: The VNET main virtual machine console may be 
reconnected through the normal VM/370 LOGON procedure. 


USERID ‘userid! NOT RECEIVING 


Explanation: An attempt has been made to disconnect the main 
VNET virtual oferator console with a secondary virtual 
machine ID identified by 'userid' specified to receive VNET 
console output mressages. The specified virtual machine 
either was not receiving messages or was not logged on at the 
time of command processing. 


System Action: The command processing is terminated, the 
command has no effect, and normal processing continues. 


Operator Action: The command can be retried with a different 
virtual machine ID specified, or with no virtual machine ID 
specified. The same virtual machine ID can be specified 
after it has been logged on and set to receive messages. 
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DMTCMX625I NO PORTS AVAILAEPLE 


Explanation: This message is issued in response to a QUERY 
SYSTEM PORTS command. At the time of command execution, no 
Switchable ports had been defined to the VNET system. 
Switchable ports are defined to the VNET system by the PORT 
entry in the VNET directory (VNET DIRECT) 


System Action: None. 


Operator Action: None. 


DMTCMX626I PORT ‘vaddr' AVATLAELE 


Explanation: This message is issued in response to a QUERY 
SYSTEM PORTS ccmmand. Either this message or message 
"DMTCMX627" is issued once for each switchable port defined 
by a PORT entry in the VNET directory (VNET DIRECT). The 
switchable port identified by its virtual device address 
‘'vaddr' was not in use by an active link at the time of 
command processing. 


System Action: None. 


Operator Action: None. 


DMTCMX627I PORT ‘vaddr' IN USE BY LINK 'linkid' 
Explanation: This message is issued in response to a QUERY 
SYSTEM PORTS command. Either this message or message 
"DMTCMX626" is issued once for each switchable port defined 
by a PORT entry in the VNET directory (VNET DIRECT). The 
switchable port identified by its virtual device address 
'vaddr' was in use Fy the active link identified by ‘linkid' 
at the time of command execution. 


System Action: None. 


Operator Action: None. 


DMTCMX630I ‘locid' NOW RCUTECD THROUGH LINK 'linkid' 


Explanation: In response to a VNET ROUTE command, file, 
command, and message transmission to the location identified 
ky ‘locid' may ke indirectly routed through the link 
identified by ‘linkid'. 


System Action: The VNET routing table has been updated to 
reflect the new indirect route. A direct link and an 
indirect route may be concurrently defined for the same 
remote location, using a Single locid. In this case, files, 
commands, and messages may be transmitted directly or 
indirectly, depending upon dynamic system status. 


Operator Action: None. 


DMTCMX631I INDIRECT ROUTING FOR tlocid'! DEACTIVATED 
Explanation: In response to a ROUTE command, files, commands, 


and messages addressed to the location identified by ‘locid' 
will no longer ke indirectly routed. 
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System Action: The VNET routing table has been updated to 

reflect the routing change. Files addressed to the 

identified locaticn are rerouted for direct transmission (if 

a link is defined), or are returned to local originating J 
users, or are purged. 


Operator Action: None. 


"locid' INVALIC ROUTE SPECIFIED 


Explanation: An invalid indirect route for the location 
identified by ‘locid' was specified on a preceding ROUTE 
command. 


System Action: The command is ignored and normal processing 
continues. 


4 
Cperator Action: The ROUTE command may be retried with a 
valid route specification. 
‘locid' NOT ROUTEL -- ROUTE LIMIT REACHED “ 
Explanation: An attempt was made to define a new route by 
means of the ROUTE command, but the maximum allowable number 
of indirect route definitions had already been reached. 
System Action: The command processing is suppressed, the 
command has no effect, and normal processing continues. 
Operator Action: An existing route definition must ke deleted 
before the command can be successfully retried. 

} 


NO LOCATICNS ROUTED 

Explanation: This message is in response to a QUERY SYSTEM 
ROUTES command. No indirect routing was defined to the VNET 
system. 


System Action: None. 


Operator Action: None. 


‘locid* ROUTEL THROUGH LINK ‘linkid' 


Explanation: This message is in response to a QUERY ‘locid' 
command. Files, commands, and messages addressed to the 
location identified Ly 'locid' may be automatically enqueued 
for indirect transmission on the link identified by 
"linkid'. 


System Action: None. 


Operator Action: None. 


tlocid' NOT ROUTEL 


Explanation: Tris message is in response to a QUERY ‘locid' 
OFF command. The specified ‘locid' was not defined for 
indirect routing at the time of command processing. 
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System Action: No action is taken, and normal processing 
continues. 


Operator Action: The command may be retried if it had been 
entered in error. 


LOCATION ‘locid' HAS A FILE QUEUE -- INCIRECT ROUTING NOT 
DEACTIVATED 


Explanation: This message is in response to a query ‘locid' 
OFF command. The specified location identified by ‘locid' 
has files queued for it on the link it is routed through. 


System Action: No action is taken, and normal processing 
continues. 


Operator Action: The command may be retried if it has been 
entered in error. If correct, use the transfer, purge or 
define commands to remove the queued files from the link the 
"locid' is routed through, and retry the command. 


LINK 'linkid' INACTIVE 


Explanation: This wessage is issued in response to a QUERY 
"locid' command. The location specified in the command was 
defined for direct connection, and its link identified by 
‘linkid' wae not active at the time of command processing. 


System Action: None. 


Operator Action: None. 


LINK "linkid' (CONNECT|ACTIVE) 'task' ‘type! 'vaddr' c 
(HO|NOH) (DR| NOL) (NOT|TRS|TRI[TSL) 


Explanation: This message is issued in response to a QUERY 
"locid' command. The location specified in the command was 
defined for direct connection, and its link identified by 
‘linkid' was active at the time of command processing. The 
CONNECT keyword indicates that the line driver successfully 
received a satisfactory response from the remote station on 
the last attempted exchange. The ACTIVE keywcrd implies that 
the line driver's last attempted exchange failed due to line 
or remote systen failure, or that local telecommunications 
equipment has not keen dialed or is nct properly set. 


task - is the task name of the line driver task. 

type - is the name of the line driver is use for the active 
link. 

vaddr - is the virtual device address of the line port in 
use by the active link. 

Cc - is the class or classes of files that may be 
processed ky the active link. 

HO - indicates that the active link is in hold status. 

NOH ~ indicates that the active link is not in hold 
status. 

DR ~ indicates that the active link is in the process of 
draining, and will terminate when line activity is 
quiesced. 

NOD - indicates that the active link is not in the process 


of draining. 
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NOT - indicates that no trace option is active for the 


link. 

TRS - indicates that the trace sum option is active for 
the link, and that the trace log option is 
inactive. 

TRL - indicates that the trace log option is active for 
the link, and that the trace sum option is 
inactive. 

TSL - indicates that both the trace sum and trace log 


options are active for the link. 
System Action: None. 


Operator Action: None. 


LINK ‘linkid! DEFAULT 'task' ‘type 'vaddr' c Z=z R=r 


Explanation: This message is in response to a QUERY ‘linkid' 
DEF command, and is automatically issued when a new link is 
defined or when an existing link definition is modified by 
means of the DEFINE command. fhe link identified by ‘linkid' 
was defined at the time of command processing, and the 
Gefault attrikutes listed in the message pertain to that 
definition. The message does not indicate whether the link 
was active or inactive at the time of command processing, and 
the default attributes listed may be different from those 
actually in use with the link if it was active. 


task - the default task name to be associated with the 
defined link's line driver task when the link is 
activated. 

type - the name of the default line driver defined for 
the link. 

vaddr - the default virtual device address of a line port 
to ke used by the link when it is activated. 

c - the default class or classes of files which may be 
processed ky the link when it is active. 

Z - the number designating the terrestrial time zone 


number in which the remote location is defined to 
reside. This is the number of time zone 
roundaries between the remote location and 
Greenwich to the east, the International Date Line 
being included as a time zone boundary. 

xr - the number of virtual storage file tag slots 
reserved for exclusive use by this link. 


System Action: None. 


Operator Action: None. 


LINK ‘linkid' S=s R=r Q=q P=p 


Explanation: This message is issued in response to a QUERY 
‘linkid' QUEUE command, and is issued in response to a QUERY 
SYSTEM QUEUE once for each link on which at least one file is 
either enqueued or active. The status of the file queue for 
the link identified by ‘linkid' is described. 


s - the number of files being actively transmitted 
(sent) on the link. 

r - the number of files being actively received on the 
link. 


Reference and Operations 


DMTCMX655I 


DMTCMX656I1 


q - the numker of files accepted and enqueued for 
transmission on the link. 
p - the number of files pending but not yet accepted 


for the active link. 


System Action: In response to a QUERY ‘linkid' QUEUE command, 
an additional message (DMTCMX655I) is issued for each file 
accepted and engueved on the link, descriking the status of 
each such file. 


Operator Action: None. 

FILE 'spoolid! (‘orgid') ‘locid' ‘userid’ CL a PR pp REC 
nnnnnnnn (HO| NOH) 

Explanation: A message of this form is issued for each file 


accepted and enqueued for transmission on the link specified 
by ‘linkid' in the preceding QUERY ‘linkid' QUEUE command. 


spoolid - the VM/370 spool file ID for the file. 

orgid - the originating VM/370 spool file ID, or the 
origin job number, of the file. 

locid - the destination location ID to which the file is 
addressed. 

userid - the destination user ID (if any) to which the file 
is addressed. 

a - the spool file class. 

pp - the file's current transmission priority. 

nmnnnnnnn - the total number of records in the file. 

HO - indicates that the file is in hold status. 

NOH - indicates that the file is not in hold status. 


System Action: This message is issued once for each inactive 
file which is enqueued and waiting to be transmitted on the 
specified link. 


Operator Action: The QUERY ‘linkid' ACTIVE command may be 
issued to determine the status of files being actively 
transmitted on the link. 


FILF 'spoolid' (‘torgid') ‘locid' ‘userid' CL a PR pp LEFT 
mmmrmmmm OF nnnnnnnn 


Explanation: This message is issued in response to a QUERY 
'linkid' ACTIVE ccmmand. The response describes the state of 
the file which was Leing actively transmitted on the link 
specified by ‘linkid' at the time the QUERY command was 
executed. The substitution fields have the following 
meaning: 


Spoolid - the VM/370 spool file ID for the active file. 

orgid - the originating VM/370 spool file ID, or the 
origin job number, of the file. 

locid - the destination location ID to which the file is 
addressed. 

userid - the destination user ID (if any) to which the file 
is addressed. 

a - the spool file class. 

pp - the file's current transmission priority. 


mmmmmmmm - the number of records in the file which remain to 
be transmitted. 
nMnnnnnnn - the total numker of records in the file. 
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System Action: None. 


Operator Action: The QUERY 'linkid' ACTIVE command may be 
issued to determine the status of inactive files enqueued for 
transmission on the link. 


FILE 'spoolid' INACTIVE ON LINK *linkid' 


Explanation: This message is issued in response to a QUERY 
FILF 'spoolid' STAT command. At the time of command 
processing, the file identified by ‘spoolid' was inactive, 
and was enqueued for transmission on the link identified by 
*linkid'. 


System Action: None. 


Operator Action: None. 


FILE '‘spoolid! ACTIVE ON LINK 'linkid' 


Explanation: This message is issued in response to a QUERY 
FILE *spoolid' STAT command. At the time of command 
processing, the file identified by ‘spoolid' was active, and 
was being transmitted on the link identified by 'linkid'. 


System Action: None. 
Operator Action: None. 


FILE 'spoolid' ORG tlocid1! ‘userid1"' ORGID ‘torgid' mm/dd/yy 
hh:mm:ss z.z.z. TO ‘locid2' 'userid2' 


Explanation: This message is in response to the VNET command 
QUERY FILE ‘spoolid' VNET. The VNET control related 
attributes of the file identified by 'spoolid' are 
described. 


locid1 - the location ID of the location at which the file 
originated. 

userid! - the user ID of the originator of the file. 

orgid - the originating VM/370 spool ID, or the origin job 


nurker, of the file. 
mm/dd/yy - the file creation date. 
hh:mm:ss - the file creation time of day. 


2éZaZe - the time zone with reference to which the time of 
day is expressed. 

locid2 - the destination location ID to which the file is 
addressed. 

userid2 - the destination user ID (if any) to which the file 


is addressed. 
System Action: None. 
Operator Action: None. 
FILE "spoolid' PR pp CL a CO nn (HO|NOH) DI 'distcode', NA 
(‘fn ft'|'dsnare') 
Explanation: This message is issued in response to the VM/370 
CP command, QUERY FILE 'spoolid' VM. The VM/370 spool system 


related attrikutes of the file identified by 'spoolid' are 
described. 
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pp - the file's priority. 

a - the file's spool file class. 

nn -~ the file's copy count. 

HO - indicates that the file is in hold status. 

NOH - indicates that the file is not in hold status. 
distcode - the file's distribution code. 

fn ft - the file's filename filetype. 

dsname - the file's data set name. 


System Action: None. 


Operator Action: None. 


FILE ‘spoolid' NOT FOUND 


Explanation: This message is issued in response to a QUERY 
FILE ‘spoolid' command. The file identified by 'spoolid' 
could not be found by VNET, meaning either that the file is 
not owned by the VNET virtual machine, or that the file is 
pending and has not yet keen accepted by VNET. 


System Action: None. 


Operator Action: Verify that the spool file ID was correctly 
typed. If it was not, retry the command with the correct 
spool file ID. If it was correctly typed, retry the command 
after some time has elapsed to allow the file to move from 
pending to enqueued status. 


NO FILE ACTIVE 


Explanation: This message is issued in response to a QUERY 
'tlinkid't ACTIVE command. At the time of QUERY command 
processing, no file was being actively transmitted on the 
specified link. 


System Action: None. 


Operator Action: None. 


LINK 'linkid' (CONNECT|ACTIVE) -- ‘'type' LINE ‘vaddr' 
(HO|NOH) (DR[|NOD) (NOT|TRS|TRI[TSL) 


Explanation: This message is issued in response to a QUERY 
SYSTEM command, or to a QUERY SYSTEM ACTIVE command. One 
such message is produced for each active link in the VNET 
facility at the time of command processing. The active link 
described ky the message is identified by ‘linkid'. The 
CONNECT keyword indicates that the line driver successfully 
received a satisfactory response from the remote station on 
the last attempted exchange. The ACTIVE keyword implies that 
the line driver's last attempted exchange failed due to line 
or remote system failure, or that local telecommunications 
equipment has not keen dialed or is not properly set. 


type - the name of the line driver in use by the active 
link. 

vaddr - the virtual device address of the line port in use 
by the active link. 

HO - indicates that the active link is in hold status. 
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NOH - indicates that the active link is not in hold 
status. 

DR - indicates that the active link is in the process 
of draining, and will terminate when line activity 
is quiesced. 


NOD - indicates that the active link is not in the 
process of draining. 

NOT - indicates that no trace option is active for the 
link. 

TRS - indicates that the trace sum option is active for 
the link, and that the trace log option is 
inactive. 

TRL - indicates that the trace log option is active for 
the link, and that the trace sum option is 
inactive. 

TSL - indicates that both the trace sum and trace log 


options are active for the link. 


System Action: This message is issued for each active link in 
the system. 


Operator Action: None. 


LINK ‘linkid' INACTIVE -- DEFAULT 'type' LINE ‘vaddr' 
Explanation: This message is issued in response to a QUERY 
SYSTEM command. One such message is produced for each 
inactive link in the VNET facility at the time cf ccmmand 
processing. The inactive link is identified by 'linkid', 
it's default line driver type is identified by 'type', and 
it's default line port virtual address is identified by 
"'vaddr'. 


System Action: This message is issued for each inactive link 
in the system. 


Operator Action: None. 


NO LINK ACTIVE 

Explanation: This message is issued in response to a QUERY 
SYSTEM ACTIVE command. The VNET system had no active link at 
the time of cormand processing. 


system Action: None. 


Operator Action: None. 


NO LINK DEFINEL 

Explanation: This message is issued in response to a QUERY 
SYSTEM command. The VNET system had no link defined at the 
time of command processing. 


System Action: None. 


Operator Action: None. 
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NO FILES QUEUEL 


Explanation: This message is in response to a QUERY SYSTEM 
QUEUE command. No files were active, and no files were 
queued or pending in the VNET input file queue at the time of 
the command processing. 


System Action: None. 


Operator Action: None. 


EXEC ‘filename’ NOT FOUND ON DISK 'vaddr' -- COMMAND FILE NOT 
EXECUTED 


Explanation: An attempt was made to execute the VNET operator 
command exec file identified by ‘'filename'. The exec file 
was not found on the VNET system disk identified by 'vaddr'. 


System Action: EXEC command processing is suppressed, the 
EXEC command has no effect, and normal processing continues. 


Operator Action: Verify that the filename was correctly 
entered on the EXEC command line, and that the specified exec 
file has a filetype of 'VNET'. If an error is found, the 
EXEC command may ke retried. If no error is found and the 
condition persists, the problem may be referred to those 
responsible fcr VNET system generation and maintenance. 


FATAL ERROR REACLING FROM ‘vaddr'! -- EXEC 'filename' 
PROCESSING TERMINATED 


Explanation: In the process of executing the VNET exec file 
identified by ‘filename', an uncorrectakle I/O error was 
encountered in reading the file from the VNET system disk 
identified by ‘vaddr'. 


System Action: EXEC command processing is terminated at the 
point of error. 


Operator Action: The command may ke retried if appropriate. 
If the error condition persists, the problem may be referred 
to those responsible for VNET system generation and 
maintenance. 


EXEC *filename't FILE FORMAT INVALID -- EXEC NOT EXECUTED 


Explanation: An attempt was made to execute the VNET operator 
command exec file identified by ‘filename'. In the process 
of reading the file from the VNET system disk, an invalid 
file format was encountered. 


System Action: EXEC command processing is terminated at the 
point of error. 


Operator Action: Verify that the EXEC command filename was 
correctly specified. If appropriate, the command may be 
retried. If the error condition persists, the problem may ke 
referred to those responsible for VNET system generation and 
maintenance. 
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EXEC 'filename' IN EXECUTION -- NEW EXEC COMMAND IGNORED 


Explanation: While executing commands from the VNET exec file 
identified by 'filename', another EXEC command was 
encountered. 


System Action: The suksequent EXEC command processing is 
suppressed, and the original EXEC command processing 
continues. 


Operator Action: Those responsible for VNET system generation 
and maintenance should be notified. 


ACTIVATING LINK linkid' 'task" ‘'type' ‘'vaddr' c 


Explanation: The link identified by ‘linkid' was inactive and 
has become active as a result of command processing. The 
message describes the variable attributes in effect for this 
active link. 


task - the task name associated with the activated link's 
line driver. 

type - the name of the. line driver in use by the activated 
link. 

vaddr - the virtual device address of the line port in use 
by tke activated link. 

Cc - the class or classes of files that can be processed 


by the activated link. 


System Action: The activated link remains active, and the 
listed attributes remain in effect, until the link is 
deactivated or the attrikutes are explicitly modified. The 
link is activated whether or not a line connection is 
complete to the remote location. Active exchange of files, 
commands, and messages will begin automatically as soon as 
the remote station has been appropriately initialized and the 
data line has keen established. 


NO SWITCHED LINE AVAILABLE -- LINK 'linkid' NOT ACTIVATEL 


Explanation: An attempt was made to activate the link 
identified by 'linkid' with no specified line port virtual 
device address. The link had no defined default line port 
address, and ne common switched line ports were available at 
the time of command processing. 


System Action: The command processing is terminated, the link 
remains inactive, and normal processing continues. 


Operator Action: The command can be retried with a specified 


line port address, or it can ke retried when a common 
Switched line pert kecomes available. 


LINE 'vaddr' IS IN USE BY LINK 'linkid1' -- LINK 'linkid2! 
NOT ACTIVATED 

Explanation: An attempt was made to activate the link 
identified by ‘linkid2'. The line port virtual device 
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address specified in the request to activate the link, 
identified by ‘vaddr', was found to be in use by another 
active link, identified by ‘linkid1', at the time of command 
processing. 


System Action: The command processing is terminated, the 
command has no effect, and normal processing continues. 


Operator Action: The command can ke retried with a specified 
line port address that is not in use by another active link, 
or it can ke retried with ro line port address specified, in 
which case an attempt will be made to reserve and utilize a 

valid line port. 


DEV 'cuuf IS NOT A LINE PORT -- LINK 'linkid' NOT ACTIVATEL 


Explanation: An attempt was made to activate the link 
identified by ‘linkid' with a line port address identified Ly 
‘fcuu'. A virtual device at address ‘cuu! exists, but it is 
not a usable line port type device. 


System Action: The command processing is terminated, the link 
remains inactive, and normal processing continues. 


Operator Action: The command can ke retried with a specified 
line port address that is valid and available, or it can be 
retried with no line port address at all, in which case an 
attempt will ke made to select and reserve a common 
Switchable line port. 


LINE 'vaddr' Cc=3 NOT OPERATIONAL -- LINK 'linkid'! NoT 
ACTIVATED 


Explanation: An attempt was made to activate the link 
identified by 'linkid' with a line port address identified by 
'vaddr'. Either ro device was defined for the VNET virtual 
machine at virtual address ‘'vaddr', or the device at that 
address was logically disconnected from the I/0 system. 


System Action: The command processing is terminated, the link 
remains inactive, and normal processing continues. 


Operator Action: The command can ke retried with a specified 
line port address that is valid and operational, or it can be 
retried with no line port address at all, in which case an 
attempt will ke made to select and reserve a common 
Switchable line port. 


DRIVER 'type' NCT FCUND ON DISK ‘vaddr't -- LINK *linkid' NOT 
ACTIVATED 


Explanation: An attempt was made to activate the link 
identified by ‘linkid' using a line driver name of ‘type’. 
The specified line driver was not found on the VNET system 
disk. 


System Action: The command processing is terminated, the link 
remains inactive, and normal processing continues. 


Operator Action: Verify that the driver name used was 


correctly typed. If it was not, retry the command with a 
corrected line driver type specification. If the command was 
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correctly typed, notify a person responsible for system 
support. Verify that the intended line driver resides on the 
VNET system disk with a filename of 'type' and a filetype of 
'TEXT®. 


FATAL FRROR LOADING FROM ‘vaddr' -- LINK 'linkid' NOT 
ACTIVATED 


Explanation: An attempt was made to activate the link 
identified by ‘linkid'. In the process of loading the link's 
line driver from the disk identified by ‘vaddr', an 
uncorrectable I/O error was encountered. 


System Action: Loading is abandoned, the error is logged, the 
command processing is terminated, and the link remains 
inactive. 


Operator Action: Retry the command. If the error condition 
persists, notify a person responsible for operations or 
System support. 


CRIVER ‘type! FILE FORMAT INVALID -- LINK ‘linkid' NOT 
ACTIVATED 


Explanation: An attempt was made to activate the link 
identified by 'linkid', with a line driver type specification 
of 'type'. In the process of reading the driver file and 
loading the driver into virtual storage, the loader detected 
an invalid data format in the driver file. 


System Action: Loading is abandoned, the command processing 
is terminated, and normal processing continues. 


Operator Action: Verify that a correct line driver type 
specification has been used. If an improper driver type was 
used, retry the command with a correct driver type 
specification. If the proper driver tyre was used, notify a 
person responsikle for system support. 


VIRTUAL STORAGE CAPACITY EXCEEDED -- LINK 'linkid' NOT 
ACTIVATED 


Explanation: An attempt was made to activate the link 
identified by ‘linkid'. During the activation process, a 
virtual free storage requirement could not ke met because 
there was insufficient virtual storage available for 
allocation by the VNET system. 


System Action: The command processing is terminated, the link 
remains inactive, and normal processing continues. 


Operator Action: A START command may ke retried later, when 
more virtual storage may Le available. Deactivating another 
link will increase available virtual storage. If this 
Situation occurs regularly, it might be corrected by 
increasing the size of the VNET virtual machine's virtual 
storage prior to VNET IPL. 
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TASK NAME 'task* ALREADY IN USE -- LINK 'linkid' NOT 
ACTIVATED 


Explanation: An attempt to activate the link ‘linkid', in 
response to a START command, failed because the task name 
'task' specified for use was in use by another task in the 
system. 


System Action: The START command is suppressed, and normal 
processing continues. 


Operator Action: Retry the START command specifying a 
different task name by use of the 'TASK' keyword, or retry 
the START command after the line driver with the conflicting 
task name ras keen deactivated. 


MAX ('nn') ACTIVE -- LINK 'linkid' NOT ACTIVATED 


Explanation: An attempt to activate the link ‘linkid', in 
reponse to a START command, failed because the maximum 
allowable number ‘nn't of concurrent active links had already 
been reached. 


System Action: The START command is ignored, and normal 
processing continues. 


Operator Action: Retry the START command after one or more 
links been deactivated. 


LINK 'linkid't ALREADY ACTIVE -- NO ACTION TAKEN 


Explanation: A START command was issued specifying the link 
identified by ‘linkid'. The link was already active at the 
time of command processing, and no modifiable attributes were 
chanced from their previous settings. 


System Action: The START command is ignored, and normal 
processing continues. 


Operator Action: None. 


TINK ‘linkid' ALREADY ACTIVE -- NEW CLASS(ES) SET AS 
REQUESTED 


Explanation: A START command was issued specifying the link 
identified by ‘linkid'. The link was already active at the 
time of command processing, and the new class specification 
for the link has keen accepted. 


System Action: The link automatically begins processing files 
bearing the newly specified class(es) if any are enqueued on 
the link. 


Operator Action: None. 


LINK *linkid' STILL ACTIVE -- DRAIN STATUS RESET 


Explanation: A START command was issued specifying the link 
identified by ‘linkid'. The link was active at the time of 
command processing, but it was in the process of terminating 
as the result of a previous DRAIN command. 
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System Action: The link remains active with the same 
attributes that had previously been in effect, except that 
the link's drain status is reset. Normal VNET processing 
continues. 


Operator Action: None. 


NUCLEUS WRITE COMPLETE 


Explanation: The VNET nucleus has keen successfully written 
to the VNET system disk. 


System Action: A masked off wait state PSW is loaded with a 
wait state code of X'12'. 


Operator Action: The newly loaded VNET system should ke 
tested by IPLing the VNET system disk onto which the nucleus 
was written. 


SYSTEM DISK ALCRESS = cuu 


Explanation: ‘cuu' designates the virtual device address of 
the disk onto which the VNET nucleus is to ke written. This 
disk becomes the VNFET system disk. 


System Action: If an invalid device address is entered, 
message 'DMTINI481E INVALIC DEVICE ADDRESS - REENTER! is 
issued. Message CMTINI4O8R is then reissued, and a valid 
VNET system disk virtual device address may be entered. 


If the IPL device designated is not currently defined, is not 
in read/write status, or is an unsupported device type, 
message 'DMTINI484E IPL DEVICE ERROR - RFENTER! is issued. 
Message DMTINI411R is then reissued. 


Operator Action: CP console function mode may be entered by 
Signalling attertior, and the status of the designated device 
may be determined by entering the CP command: 

QUERY VIRTUAI cuu 
Corrective action may be taken to define the device for: the 
VNET virtual machine, or to access it in read/write status. 
VNET may be reentered by issuing the CP ccmmand: 

FEGIN 


The VNET system device address may then be entered in 
response to this message. 


Once the IPL device address is accepted, the message 
DMTINI412R is issued. 

REWRITE THE NUCLEUS ? {YFS|NO} 

Explanation: The VNET loader is prompting the oprerator for a 
decision as to whether or not the VNET nucleus is to be 


rewritten to the system disk. 


System Action: If a response other than ‘yes or 'no! is 
given, message "DMTINI483E INVALID REPLY - ANSWER "YES" OR 
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"No"’ is issued. Message "DMTINI412R' is reissued anda 
valid response may ke entered. 


If 'no' is entered, the remaining questions pertaining to the 
writing of the VNET nucleus are skipped, and initialization 
is immediately kegun by the VNET system which has been loaded 
into virtual storage. 


If ‘yes' is entered, message 'DMTINI413R' is issued. 


Operator Action: Enter ‘yes' or 'no', as described above. 


NUCLEUS CYL ADDRESS = nnn 


Explanation: ‘nnn! designates the cylinder address on the 
designated VNFET system disk to which the VNET nucleus is to 
ke written. ‘nnn' is entered in decimal, and normally is the 
number of the first cylinder keyond the area of the disk in 
use for CMS files. This number will normally be the same as 
the number of cylinders previously specified in the CMS 
command: 


FORMAT ‘cuu!t ‘mode 'nnn't (RECOMP 


System Action: If a valid decimal cylinder number is not 
entered, message 'DMTINI482E INVALID CYLINDER NUMBER - 
REENTER' is issued, followed ky reissue of message 
"DMTINI413R°. 


If the cylinder specified is not greater than the number of 
cylinders already in use on the device for CMS files (as 
specified in a preceding CMS FORMAT command), then the 
message "DMTINI485E CYLINDER IN USE FOR CMS FILES! is 
issued. Message 'DMTINI413R* is then immediately reissued. 


When the nucleus cylinder address is correctly entered, 
message 'DMTINI410R* is issued. 


Operator Action: The cylinder number may ke reentered 
correctly if it had been previously entered in error. If the 
cylinder number had not been erroneously entered, the 
cylinder number is not valid and a valid number must be 
determined. The CMS command: 


QUERY DISK ‘rode! 


may be used to determine the number of cylinders formatted 
for use by the CMS file system. The CP command: 


QUERY VIRTUAL ‘'vaddr' 


may be used to determine the total number of cylinders on the 
virtual disk. If the number of cylinders in use for CMS is 
less than the total number of cylinders available on the 
disk, the number of cylinders in use for CMS files should be 
used as the VNET nucleus cylinder address when the VNET load 
is retried. If the number of cylinders in use for CMS files 
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is equal to the total number of cylinders available on the 
disk, the CMS command: 


y 
FORMAT 'vaddr't tmode' ‘nnn! (RECOMP J 
should be used to reduce the number of cylinders in use by 
CMS, as descriked in the VNET installation procedures 
documentation. 
INVALID DEVICE ACDRESS - REENTER 
Explanation: The device address entered was not correct. It 
either included at least one character which is not a valid 
hexadecimal digit (0-9, A-F) or it was not within the range 
of valid device addresses (X'001'-X'6FF*). 
System Action: Message 'DMTINI411R* is reissued. 4 
Operator Action: See the description of message 
"DMTINI411R°. 
INVALID CYLINDER NUMEPER - REENTER 


Explanation: Fither zero or an invalid decimal number was 
entered. 


System Action: Message 'DMTINI413R* is reissued. 
Operator Action: See the description of message 
"DMTINI413R°. 

INVALID REPLY - ANSWER "YES" OR "NO" 


Explanation: The only valid responses to the query are ‘'yes' 
or 'no'. Neither was entered. 


System Action: Message "DMTINI412R*' is reissued. 


Operator Action: See the description of message 
"DMTINIG12R°*. 


IPL DEVICE ERROR - REENTER 


Explanation: The virtual device address entered as the 

address of the VNET system disk was not defined (attached) } 
for the VNET virtual machine, or the disk was not in 

write/read status, or the device at the entered address is 

not supported. 


» 


System Action: Message "DMTINI411R* is reissued. 

Operator Action: See the description of message 
"DMTINIG11R¢. 

CYLINCER IN USE FOR CMS FILES 

Explanation: The specified nucleus cylinder number was not 


greater than the number of cylinders indicated in the CMS 
Master File Directory for the VNET system disk. 


Reference and Operations 


System Action: Message '"DMTINI413R' is reissued. 


Operator Action: See the description of message 
"DMTINI413R°. 


DMTINI498S IPL CEVICE WRITE I/0 ERROR 


Explanation: An uncorrectakle I/O error was encountered while 
attempting to write the VNET nucleus. 


System Action: VNET load processing is halted, and a masked 
off wait state PSW of code X'12' is loaded. 


Operator Action: See the description of message 
"DMTINIG13R'. Verify that the nucleus cylinder number 
entered in regponse to message "'DMTINI413R!' is not larger 
than the total number of cylinders on the specified VNET 
system disk, and verify that the VNET system disk is in 
write/read mode. If no error can be determined, those 
responsible fcr VNET system support should ke contacted. 


DMTINI499T IPL CEVICE REAL I/O ERROR 


Explanation: An uncorrectakle I/O error was encountered while 
attempting to read the VNET nucleus from the VNET system 
disk. 


System Action: A masked off wait state PSW of code X'11' is 
loaded. 


Operator Action: The IPL may ke retried. If the problem 
persists, persornel responsible for VNET system support 
should be notified. 


DMTIRXOOOI VNET VER v, LEV 1, mm/dd/yy READY 


Explanation: This message signals the completion of VNET 
initialization, including the activation of the AXS and LAX 
tasks. VER v and LEV 1 specify the version and level of VNET 
that is in use. mm/dd/yy specifies the date on which the VNET 
in use was generated. 


System Action: The system kegins normal processing by 
accepting files and commands. 


Operator Action: Normally, one or more links are activated at 
this time. 


DMTIRX4O0I VNET DIRECT mm/dd/yy hh:mm, nn MAX ACTIVE LINKS, tt TAGS 


Explanation: This message is generated at system 
initialization immediately following the initial VNET message 
"DMTIRXOOOI*. The directory file ('VNET CIRECT') used to 
initialize the VNET system was last modified at the date and 
tire specified ky mm/dd/yy hh:mm. 


nn is the maximur number of links that may ke active at one 
time. This number is calculated based on the virtual 
storage size of the VNET virtual machine. 
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tt indicates the total numker of available tag slots. This 
number also defends on available virtual storage size. 


System Action: Initialization proceeds with the execution of 
the PROFILE VNET command file, if any, and normal VNET 
processing kLegins. 


operator to verify the version of the VNET directory used to 
initialize the system. 


MAX TAGS REQUEST OF 1 PER VIRTUAL STORAGE K ASSUMED 


Explanation: The VNET directory contained a valid TAGS entry 
requesting a numrker of extra tag slots in excess of the 
raximum allowed for the virtual storage size in use. The 
referenced TAGS statement is typed immediately preceding this 
statement. The maximum permitted number of extra tag slots 
is one extra tag slot for each 1024 bytes of virtual storage 
size. 


System Action: The maximum permitted number of extra tag 
Slots are generated, and normal initialization proceeds. 


Operator Action: It should be verified that the correct VNET 
directory is in use, and that the VNET virtual machine has 
the intended virtual storage size. If both are the case, the 
TAGS entry in the VNET directory should be modified to 
request a numker of extra tag slots no greater than the 
allowed maximum for the virtual storage size in use. 


INVALID DIRECTORY ENTRY 


Explanation: During initialization, the VNET directory was 
found to contain a record which was neither a comment nor a 
valid directory entry. The referenced record is typed 
immediately preceding this message. 


System Action: The record is ignored and normal 
initialization processing continues. 


Operator Action: This message indicates an error in the 
preparation of the VNET directory. The directory should be 
updated to correct the desired entry, or to eliminate the 
invalid record. 


CIRECTORY ENTRY OUT OF ORDER 


Explanation: Curing initialization, a VNET directory entry 
was recognized in a position which either precedes a 
prerequisite entry.or follows a valid entry which it is 
required to precede. The referenced entry is typed 
immediately preceding this message. 


System Action: The entry is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should te updated to 
correct the erroneous order of entries. 
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LOCAL PREVIOUSLY SPECIFIED 


Explanation: Durirg initialization, a VNET directory entry 
describing the local location ('LOCAL') was recognized 
following the acceptance of a previous valid LOCAL entry. 
The referenced entry is typed immediately preceding this 
entry. 


System Action: The preceding LOCAL entry remains in effect, 
the .subsequent LOCAL entry is ignored, and normal 
initialization frocessing continues. 


Operator Action: The VNET directory should ke updated to 
include only one LOCAL entry. 


PARM PREVIOUSLY SPECIFIEL FOR LINK 


Explanation: Curing intialization, the VNET directory was 
found to contain an entry specifying a default START parm 
("PARM') on a link for which a previous valid PARM entry had 
been encountered. The referenced entry is typed immediately 
preceding this message. 


System Action: The subsequent PARM entry is ignored, the 
first PARM entry encountered for the link remains in effect, 
and normal initialization processing continues. 


Qperator Action: The VNET directory should ke updated to 
remove multiple PARM entries which specify the same link. 


TAGS PREVIOUSLY SPECIFIED 


Explanation: Curing initialization, tke VNET directory was 
found to contain more than one request for extra tag slots 
("TAGS'). This message is produced each time a TAGS entry is 
encountered after a valid previous TAGS record was 

processed. The subsequent TAGS entry is typed immediately 
preceding the message. 


System Action: The first valid TAGS entry encountered in the 
VNET directory remains in effect. The subsequent TAGS entry 
is ignored, and norral initialization processing continues. 


Operator Action: The VNET directory should be updated to 
contain a single valid TAGS entry. 


DUPLICATE LOCATION ID 


Explanation: Curing initialization, the VNET directory was 
found to contain a routing entry ('ROUTE') which specified a 
destination location ID which had been specified ina valid 
previous ROUTE entry. The subsequent ROUTE entry is typed 
immediately preceding this message. 


System Action: The original ROUTE entry remains in effect, 
the subsequent ROUTE entry is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should ke updated to 


contain no more than one ROUTE entry for a single, unique 
destination location ID. 
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found to contain a link definition entry ('LINK') specifying 
a link ID which had been specified in a valid previous LINK 
entry. The suksequent LINK entry is typed immediately 
preceding this message. 


Explanation: During initialization, the VNET directory was ) 


System Action: The preceding LINK entry remains in effect, 
the subsequent LINK entry is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should Le updated to 
include no more than one LINK entry which specifies a single, 
unique link IC. 


Explanation: During initialization, the VNET directory was 
found to contain more than one switchable port entry ('PORT') 
which specified the same port address. The subsequent PORT 
entry is typed immediately preceding this message. 


System Action: The preceding PORT entry remains in effect, 
the subsequent PORT entry is ignored, and normal 
initialization frocessing continues. 


Operator Action: The VNET directory should ke updated to 
contain no more than one PORT entry for a single, unique port 
address. 


DMTIRX458E UNDEFINED LINK IC 


Explanation: Luring initialization, the VNET directory was 
found to contain a default parameter entry ("PARM') ora 
routing entry ('ROUTE') specifying a link ID for which no 
link had been defined. The referenced entry is typed 
immediately preceding this message. 


System Action: The PARM or ROUTE entry is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should be updated such 
that all link IDs specified in PARM and ROUTE entries have 
been defined Ly previous LINK entries. 


DMTIRX461E LOCATION ID MISSING OR INVALID 3 
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Explanation: Luring initialization, the VNET directory was 
found to contain a local definition entry ('LOCAL') or 
routing entry ('ROUTE') specifying a local or destination 
location ID which was too long or contained invalid 
characters, or the location ID was not specified at all. The 
referenced LOCAL or ROUTE entry is typed immediately 
preceding this rnessage. 


System Action: The LOCAL or ROUTE entry is ignored, and 
normal initialization processing continues. 


Operator Action: The VNET directory should be updated to 
contain the valid location IDs desired by the installation. ; 
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LINK ID MISSING OR INVALID 


Explanation: Curing initialization, the VNET directory was 
found to contain a link definition entry ('LINK'), a default 
parm entry ('PARM'), or a routing entry ('ROUTE') specifying 
a link ID which was too long, contained invalid characters, 
or was identical to the previously defined local location IDL, 
or which did not specify a link ID at all. The referenced 
LINK, PARM, or ROUTE entry is typed immediately preceding 
this message. 


System Action: The entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should be updated to 
contain the valid link IDs desired by the installation. 


INVALID DRIVER SPECIFICATION 


Explanation: During initialization, the VNET directory was 
found to contain a link definition entry ('LINK') specifying 
a driver type (CMS filename) which was too long, or which 
contained invalid characters. The referenced LINK entry is 
typed immediately preceding this message. 


System Action: The entry in error is ignored, and normal 
initialization precessing continues. 


Operator Action: The VNET directory should be updated to 
contain the valid line driver type desired by the 
installation. 


PORT ADDRESS MISSING OR INVALID 


Explanation: Curing initialization, the VNET directory was 
found to contain a link definition entry ("LINK") or 
Switchable port entry ('PORT') specifying a port address 
which contained invalid characters or which was out of the 
valid port address range (X'000'-X'6FF'); or the port address 
was not specified at all ona PORT entry. The referenced 
LINK or PORT entry is typed immediately preceding this 
message. 


System Action: The LINK or PORT entry in error is ignored, 
and normal initialization processing continues. 


Operator Action: The VNET directory should ke updated to 
contain the valid port address desired by the installation. 


INVALID ZONE SPECIFICATION 


Explanation: During initialization, the VNET directory was 
found to contain a local location definition entry ('LOCAL') 
or a link definition entry ('LINK') specifying a time zone 
number which contained invalid characters, or which was not 
within the range of valid time zone numbers. The time zone 
numker is defined as the number of time zone boundaries 
ketween the location and Greenwich to the east, the 
International Cate Line being included as a time zone 
roundary; and tke valid range of time zcne numbers is 9 to 24 
decimal. The referenced LOCAL or LINK entry is typed 
immediately preceding this message. 
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System Action: The LOCAL or LINK entry in error is ignored, 
and normal initialization processing continues. 


Operator Action: The VNET directory should ke updated to 
contain the valid time zone number desired by the 
installation. 


INVALID TASK SPECIFICATION 


Explanation: Curing initialization, tke VNET directory was 
found to contain a link definition entry ('LINK') specifying 
a default task name which contained more than. four 
characters, or invalid characters. The referenced LINK entry 
is typed immediately preceding this message. 


System Action: The LINK entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should be updated to 
contain the valid task name desired by the installation. 


INVALID CLASS SPECIFICATION 


Explanation: Curing initialization, the VNET directory was 
found to contain a link definition entry ('LINK') specifying 
a default class which contained more than four characters, or 
invalid characters. The referenced LINK entry is typed 
immediately preceding this message. 


System Action: The LINK entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should be updated to 
contain the valid class specification desired by the 
installation. 


INVALID KEEP SPECIFICATION 


Explanation: During initialization, the VNET directory was 
found to contain a link definition entry ('LINK') specifying 
a keep number which contained invalid characters, or which 
was not within the range of valid keep numbers (0 to 16 
decimal). The keep number specifies the rinimur number of 
tag slots which are to be kept available for exclusive 
enqueueing of files on the link being defined. The 
referenced LINK entry is typed immediately preceding this 
message. 


System Action: The LINK entry in error is ignored, and normal 
initialization processing continues. 


contain the valid number of tag slots desired by the 
installation to ke reserved for the link to ke defined. 


TAGS COUNT MISSING OR INVALID 


Explanation: During initialization, the VNET directory was 
found to contain a tag slot request entry ('TAGS') which 
specified an extra tag slot count containing invalid 
characters, or which was not within the valid range for extra 
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tag slot requests (1 to 16384 decimal). The referenced TAGS 
entry is typed immediately preceding this message. 


System Action: The TAGS entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: The VNET directory should ke updated to 
specify the valid keep number of extra tag slots desired by 
the installation. 


UNSUPPORTED SYSTEM RESIDENCE DEVICE TYPE 


Explanation: The VM/370 device type code for the I/0 device 
from which VNET was IPLed was not recognized as a DASD device 
type supported Ly VNET as a system residence device. 


System Action: VNET initialization is terminated, and a 
masked off wait state PSW is loaded. 


Operator Action: The VNET system must be reloaded to a DASD 
device which is supported by the VNET system in use as a 
system residence device. 


FATAL ERROR REACLING VNET DIRECT 


Explanation: An unrecoveratle I/O errcer occurred during 
initialization on the VNET system residence device. The most 
likely cause of this error is the absence of the VNET 
directory file ("VNET DIRECT!) from the system residence 
device. Other possible causes include VM/370 sysgen or 
directory errors invloving the VNET system residence device, 
CMS or editor system errors in writing the VNET DIRECT file, 
incompatible CMS file system update levels, or machine 
malfunctions on the associated real I/O device. 


System Action: VNET system initialization is terminated, and 
a masked off wait state PSW is loaded. 


Operator Action: The VNET IPL should ke retried. If the 
error condition persists, the possible causes listed in the 
explanation akove should be investigated, and any detected 
specification errors should ke corrected. If the error 
condition continues to persist, or if it arises 
intermittently, the VNET system should be dumped using the CP 
command: 


CUMP O- 


The resulting dump should be submitted to those responsikle 
for VNET system support. 


FATAL ERROR LOALCING CMTAXS 


Explanation: An unrecoverakle I/O error occurred during the 
initial loading of the VNET DMTAXS module. The most likely 
causes of this error are the absence of the 'DMTAXS TEXT! 
file from the VNET system residence device, or the incorrect 
naming of the file as "DMTAXS TXTxxxx'. Other possible 
causes include CMS or assembler system errors in writing the 
DMTAXS TEXT file, incompatible CMS file system update levels, 
or machine malfunctions on the associated real I/O device. 
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System Action: VNET system initialization is terminated, and 
a masked off wait state PSW is loaded. 


Operator Action: The VNET IPL should ke retried. If the 
error condition persists, the possible causes listed in the 
explanation akove should be investigated, and any detected 
Specification errors should ke corrected. If the error 
condition continues to persist, or if it arises 
intermittently, the VNET system should be dumped using the CP 
commana: 


CUMP 0- 


The resulting dump should be submitted to those responsible 
for VNET system support. 


FATAL ERRCR LOALING CDMTLAX 


Explanation: An unrecoverakle I/O error occurred during the 
initial loading of the VNET DMTLAX module. The most likely 
causes of this error are the absence of the ‘DMTLAX TEXT! 
file from the VNET system residence device, or the incorrect 
naming of the file as "DMTLAX TXTxxxx'. Other possible 
causes include CMS or assembler system errors in writing the 
DMTLAX TEXT file, incompatible CMS file system update levels, 
or rachine malfunctions on the associated real I/O device. 


System Action: VNET system initialization is terminated, and 
a masked off wait state PSW is loaded. 


Operator Action: The VNET IPL should ke retried. If the 
error condition persists, the possible causes listed in the 
explanation above should ke investigated, and any detected 
specification errors should be corrected. If the error 
condition continues to persist, or if it arises 
intermittently, the VNET system should be dumped using the CP 
command; 


DUMP 0- 


The resulting dump should ke sukmitted to those responsible 
for VNET system support. 


LOCAL LOCATION CEFINITION MISSING 


Explanation: During initialization, no valid local location 
definition entry ('*LOCAL') was encountered in the VNET 
directory. The local location definition must be included as 
the first non-comment entry in the VNET directory. No 
directory entry is accepted until a valid LOCAL entry has 
been processed. 


System Action: VNET initialization processing is terminated, 
and a masked off wait state PSW is loaded. 


Operator Action: The VNET directory must ke updated to 


contain a valid LOCAL entry as the first non-comment 
directory entry. 
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INCOMPATIPLE NJI BUFFER SIZES -- LINK ‘'linkid' IS BEING 
DEACTIVATED 


Explanation: The connection control information received from 
the remote station specifies a different buffer size than 
that specified at the local location. 


System Action: The affected line driver executes its 
disconnect procedure, and the link is automatically 
deactivated. 


Operator Action: Local VNET system support personnel should 
be notified of the problem. 


INVALID NJI SIGNON CONNECTION RECORD RECEIVED -- LINK 
‘linkid' IS BEING DFACTIVATED 


Explanation: An invalid signon record has been received from 
the remote station. 


System Action: The affected line driver executes its 
disconnect procedure, and the link is automatically 
deactivated. 


Operator Action: The local VNET system support personnel 
Should be notified of the proklem. 


INVALID NJI PARAMETER *parm' ON TAG -- PARAMETER IGNORED © 


Explanation: In the scanning of file tag specified by the 
local originating user, an invalid parameter identified by 
‘parm' was encountered. 


System Action: The invalid parameter is ignored, its 
applicable default aprflies, and file processing continues. 


Operator Action: None. 


NOI LINK *linkid!: (JOB{ OUTPUT) (torgid'), JOENAME ‘'7job', 
PGMR tuser't 


Explanation: This message is automatically issued each time 
the NJI line driver for the active link identified by 
"linkid' encounters a jok header record in the data stream 
being received from the remrote system. The job header 
defines the beginning of a job or job output in the data 
stream being received. The substitution parameters in the 
message specify the following: 


JOB - denotes the beginning of reception of a job file. 

OUTPUT ~ denotes the beginning of reception of a job output 
file. 

orgid - identifies the jok file's origin spool ID or job 
nurcker. 

job - identifies the jok name of the job or output file 
keing received. 

user - identifies the originating user's programmer name 


or user ID. 
System Action: The jok or output file is written to the 


VM/370 spool system as it is received, and it is forwarded to 
the next link on its path, delivered to a local user, or 
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processed on a lccal real spool output device, depending on 
its destination address. 


Operator Action: None. 


INVALID NJI EUFFER SIZE SPECIFIED -- LINK 'linkid'! NOT 
ACTIVATED 


Explanation: During initial processing immediately following 
link activation, the line driver encountered an invalid 
kuffer size request. 


System Action: The specified link is automatically 
deactivated. 


Operator Action: The START command may be retried specifying 
a valid buffer size. If the problem persists, local VNET 
system support personnel should be notified. 


INVALID NJI NOLCAL RESISTANCE SPECIFIED -- LINK "linkid' NOT 
ACTIVATED 


Explanation: Curing initial processing immediately following 
link activation, the line driver encountered an invalid nodal 
resistance specification. 


System Action: The specified link is automatically 
deactivated. 


Operator Action: The START command may be retried specifying 
a valid nodal resistance. If the problem persists, local 
VNET system support personnel should be notified. 


SIGNON TYPE PARAMETER MISSING 


Explanation: The sign-on record previously entered did not 
include a TYPE parameter specifying the type of remote 
terminal in use. 


System Action: The link remains active but not signed on, and 
file, command, and message exchange for the link remains 
suspended pending successful sign-on. 


should be corrected, the TYPE parameter should be included on 
the sign-on card, and the sign-on procedure should be 
retried. 


NO REMOTE PUNCH AVAILABLE ON LINK ‘linkid' -- FILE 'spoolid' 
PURGED 


Explanation: An attempt was made to transmit a punch file to 
a remote terminal which was not equipped to produce punched 
output. 

System Action: The specified file is purged. 


Operator Action: None. 
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LINK 'linkid' CEACTIVATED 


Explanation: The link identified by 'linkid' has been 
deactivated as a result of the execution of a previous DRAIN 
or FORCE command, or as the result of a line driver terminal 
error. 


System Action: The link's line driver task is deleted from 
the system, all storage allocated to the task is made free, 
and the link takle entry is updated. The link remains 
inactive until it is reactivated by a START command. 


Operator Action: If the link deactivation was spcntaneous, 
that is, not as the result of a DRAIN command, the link 
should ke restarted by a START command. If spontaneous 
deactivations recur, the local VNET system support personnel 
should be notified. 


PROGRAM CHECK -- LINK "linkid' DEACTIVATED 


Explanation: A program check interrupt occurred while the 
line driver for the link identified by 'linkid'! was 
executing. There are no normal cases in which this situation 
arises, and it prokably reflects either a software or system 
generation error in either VNET or CP. 


System Action: A dump of VNET virtual storage is 
automatically taken and queued for real spool print output. 
The affected link is automatically deactivated. Normal VNET 
operation for other links is not affected. 


Operator Action: Hard copy VNET console output leading up to 
the program check should ke retrieved, if possible, and 
attached to the VNET virtual dump when it has printed. The 
dump and the console output should be turned over to those 
responsible for VNET system support. 


PROGRAM CHECK IN SUPERVISOR -- VNET SHUTDOWN 


Explanations A program check interrupt has occurred during 
the execution of MSUP, the VNET supervisor, or during 
execution of cne of the VNET system control tasks, REX, AXS, 
or LAX. There are no normal cases in which this situation 
arises, and it prokably reflects either a software or system 
generation error in either VNET or CP. 


System Action: A dump of VNET virtual storage is 
automatically taken and queued for real spool print output. 
Messages queued for operator output are written to the 
operator console, and VNET terminates by loading a masked off 
wait state PSW with wait state code x'001'. 


Operator Action: When this situation arises immediately 
following VNET IPL, hard copy VNET console output leading up 
to the program check should ke retrieved, if possible, and 
attached to the VNET virtual dump when it has printed. fMThe 
dump and the console output should be turned over to those 
responsible for VNET system support. The VNET system should 
ke re-IPLed, and dialable links should ke restarted and 
reconnected. 
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CMTREX091T INITIALIZATION FAILURE -- VNET SHUTDOWN 
Explanation: An unrecoveratle error occurred during the 
initial loading of the supervisor components, MSUP, RFX, AXS, 
and LAX. 
System Action: A virtual storage dump is automatically taken, 
and a masked off wait state PSW is loaded, terminating system 
operation. 
Operator Action: Hard copy VNET operator console output 
should be retrieved if possible, attached to the VNET storage 
dump after it has keen printed, and turned over to those 
responsible for VNET system support. The VNET system IPL may 
ke retried. 

DMTREX679I EXECUTING 'filename* COMMAND: (command line) 
Explanation: The VNET command included in the message as 
(command line) has keen read from the VNET exec file 
identified by 'filenamre', and will be executed. 


System Action: The specified command is executed, and EXEC 
command processing continues. 


Operator Action: None. 


DMTRGX330E USERID MISSING OR INVALID 


Explanation: In a preceding VNET MSG command, the userid was 
not supplied or was invalid at its destination location. 


System Action: The message is discarded undelivered. 


User Action: The MSG command may ke retried if the user ID 
was entered in error. 


DMTRGX331E ‘userid! NOT LOGGED ON 
Explanation: The user identified by ‘userid which was 
specified in a VNET MSG command could not receive the message 
recause the user was not logged on. 


System Action: The message is discarded undelivered. 


User Action: The MSG command may ke retried at a later time. 


CMTRGX332E ‘userid! NOT RECEIVING 
Explanation: The user identified by ‘userid’ which was 
specified in a VNET MSG command cannot receive console 
messages because the user's console is disconnected, or 
because the user has set messages or warnings off using the 
CP SET command. 
System Action: The message is discarded undelivered. 


User Action: The MSG command may ke retried at a later time. 
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INVALID SML MODE SPECIFIED -- LINK 'linkid' NOT ACTIVATED 


Explanation: Curing initial processing immediately following 
link activation, the line driver encountered an invalid mode 
specification. 


System Action: The specified link is automatically 
deactivated. 


Operator Action: The START command may ke retried specifying 
a valid mode. If the problem persists, lccal VNET system 
Support personnel should ke notified. 


INVALID SML PUFFER PARAMETER -- LINK ‘linkid' NOT ACTIVATED 
Explanation: During initial processing immediately following 
link activation, the line driver encountered an invalid 


buffer specification. 


System Action: The specified link is automatically 
deactivated. 


Operator Action: The START command may ke retried specifying 
a valid buffer request. If the problem persists, local VNET 
system support personnel should be notified. 

LINK 'linkidt IN RJE MODE -- PRINT FILE 'spoolid' PURGED 
Explanation: An attempt was made to transmit a print file on 
a link which was operating as a workstation submitting jobs 
to a remote batch system. When operating in this mode, print 
file cannot be transmitted. 


System Action: The specified file is automatically purged. 


Operator Action: None. 


VNET MESSAGES GENERATED FY MORE THAN ONE MODULE 


In some cases, the Same message can be generated by more than one VNET 
module. This section contains explanations of such messages. 


The rodule 


code in these messages appears in this section as ‘'xxx', as 


for example, DMTxxx070E. When the message is issued, however, the xxx is 
replaced by the three letter code for the issuing module. 


DMTxxx070EF I/O ERROR cuu SIOCC cc CSW csw SENSE sense CCW ccw 


Explanation: A message of this format is issued by any task 
in VNET that cetects an uncorrectable hardware or system 
error during the processing of an I/O operation. The causes 
of such an error vary, depending on the particular device 
type and command code. 


cuu - the virtual device address of the I/O device on 
which the error occurred. 
cc - the condition code resulting from the issuing of the 


SIO command on the device for the operation which 
was in error. 
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csw - the composite CSW associated with the operation in 
error. The composite CSW is a logical ORing of the 
CSW information associated with the SIO or the 
interrupts from the device while the I/0 operation 
was active. 


sense - the sense information associated with the I/0 
operation in error if the I/0 operation ends with 
unit check set on. 

Cccw - the first cCW of the I/O operation in error if it 
failed to start, or the last CCW fetched by the 
channel ktefore the I/O operation terminated with an 
error indication. 


System Action: The error is logged, and appropriate recovery 
procedures are taken. The exact effect of the I/O error 
condition depends on the existing conditions when it occurs. 
The system may continue processing normally, the link may be 
automatically deactivated, or VNET may shut down. 


Operator Action: This message may indicate a serious system 
or hardware error, or it may indicate common conditions such 
as interventicn required. If the message is issued 
unexpectedly, VNET system support personnel should be 
notified. 


SYSTEM ERROR REACING SPOOL FILE ‘'spoolid' 


Explanation: A return code reflecting a VM/370 system error 
has keen received in response to a read to the file 
identified by ‘'spoolid'’. 


System Action: The error is logged and the failing operation 
is retried up to ten times. If a retry is successful, normal 
processing continues. If the error persists, an attempt is 
made to purge the file and a message to that effect is issued 
to the operator and to the originating virtual machine. 


Operator Acticn: This message indicates a VM/370 system 
error. Local system support personnel should be notified. 


LINE tvaddr' REALCY FOR CONNECTION TO LINK 'linkid' 


Explanation: This message is issued by a line driver to 
inform the operator that the line identified by ‘vaddr' is 
keing enabled for communications processing to the link 
identified by ‘linkid'. Normally, this is the first message 
issued by a line driver after link activation, and it may be 
issued during active processing after a line becomes 
disconnected. 


System Action: The line driver begins an enable operation on 
the line and waits for completion, signalling a completed 
connection. If the line identified by ‘vaddr' is a 
non-switchable line, the connection completes automatically 
when the teleccmmunications hardware is properly configured 
and functional. Normal VNET processing continues. 


Operator Action: No response is needed if the line identified 
by ‘vaddr' is a non-sSwitchable line, or if it is a switchakle 
line with auto-answer and the remote station is to complete 
the connection. If the line is a Switchable line, the 


orerator should ensure that the necessary steps are taken to 
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complete the connection to the location identified by 
'linkid' (typically, he should dial and establish the 
connection). 


LINK *linkid' LINE ‘vaddr' DATASET READY 


Explanation: This message signals completion of the line 
connection for the link identified by ‘linkid' on the line 
fort address identified by ‘vaddr'. This message is issued 
automatically when a non-switchable line is enabled, and it 
is issued when a connection is completed for a switchable 
line. This message does not necessarily indicate that any 
successful interaction with the remote station has taken 
place on the connected line. 


System Action: Normal exchange of files, commands, and 
messages automatically begins if the telecommunication 
hardware and renote system are properly initialized and 
functioning correctly. 


Operator Acticn: None. 


LINK *linkid' LINE 'vaddr' DISCONNECTED 


Explanation: The virtual line port address identified by 
'vaddr' and associated with the active link identified ky 
"linkid' is now disconnected, having keen connected prior to 
the message. This may be the result either of an apparent 
line disconnection due to line errors, cr of a remote station 
disconnection, cr of the execution of a disabling sequence Ly 
the local line driver during link deactivation. 


System Action: If the link is not in the process of 
deactivating, the line driver will automatically attempt to 
reestablish the line connection. Exchange of files, 
commands, and messages is suspended until the line 
reccennection is completed. 


Operator Action: If the link is not being deactivated, 
installation procedures for reconnecting the line should be 
carried out. 


RECEIVING FILE (torgid') ON LINK 'linkid' FROM 'locid' 
fuserid', REC nnnnnnnn 


Explanation: This message indicates that reception of a new 
file from the remote location identified by 'locid' and user 
at that location identified by ‘userid! (if any) has begun. 
The file being received has an origin spoolid indicated by 
"orgid' and contains the numker of records indicated ky 
‘nnnnnnnn'!. 


System Action: File processing continues, and the new file is 
written to the VM/370 spool system as it is received. 


RECEIVED FILE ('orgid') ON LINK ‘linkid' TO 'locid! ‘userid! 


Explanation: A new file has Leen completely received and 
acknowledged on the link identified by ‘linkid'. The 
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originating srfoolid or jok number of the new file is 
identified by ‘orgid'. The file received is addressed to the 
location identified by ‘locid' and the to the user at that 
location identified by ‘userid’. 2» 


System Action: If the file is addressed to the local location 
it is automatically spooled to the receiving user or queued 
for real output. If the file is addressed to another 
location it is automatically engqueued for transmission on the 
next link of its path. Normal link processing continues. 


Operator Action: None. 


SENCING FILE 'spoolid' (torgid') ON LINK "linkid' FROM 
"locid' ‘userid’, REC nnnnnnnn 


Explanation: This message indicates that transmission of a 

file from the remote location identified by ‘locid' and user bd 
at that location identified by ‘userid! (if any) has begun. 

The file being transmitted has an origin spoolid indicated Ly 

"orgid' and contains the numkter of records indicated by 

‘nnnnnnnn'. The identified file has become active. 


System Action: Transmission of the file will normally 
continue to. corpletion. If the file transmission is 
interrupted ty a system failure or telecommunication hardware 
failure, the file will be retained and retransmitted, either 
from the point cf interruption or from the beginning, 
depending on variakle system characteristics and error 
conditions. 


Operator Action: None. 


SENT FILE 'spoolid! ('orgid') ON LINK 'linkid' TO ‘locid' 
fuserid' 


Explanation: Transmission of the active file identified by 
"spoolid' on the link identified by ‘linkid' has been 
successfully ccnpleted and acknowledged by the remote 
Station. The file is addressed to the location identified by 
"locid', and to the user identified by ‘userid’ at that 
location. The file's originating spoolid or ‘job number is 
identified -ty ‘torgid'. 


System Action: LCisposition of the identified file follows, 

according to the status of the file. Normally the file would 

be purged, unless multiple copies of the file are being sent 

to a remote terminal. Normal link processing continues. @ 


Operator Action: None. 


ACTIVE FILE 'spoolid' SENDING RESUMED ON LINK ‘linkid' : 


Explanation: Transmission of the file identified by 'spoolid' 
on the link identified by ‘linkid' has been resumed from the 
point at which transmission had previously been interrupted. 
File transmission may have been interrupted as the result of 
a telecommunication hardware failure, an unexpected terminal 
error in the link's line driver, a remote system failure, or 
entry of the link into immediate hold status. 
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System Action: Normal link processing continues. 


Operator Action: None. 


LINK *linkid' LINE ACTIVITY: TOT= mmmmmmmm; ERRS= nnnnnnnn3; 
TMOUTS= PPEPPEFEL 


Explanation: This message is issued in response to a TRACE 
'linkid' SUM ccnrmand, and occasionally thereafter while trace 
sum mode remains in effect for the specified link. The 
message is reissued when any cne of the trace values reaches 
its incremental threshold, normally 20 for NPT, VMB, and VMC; 
and 60 for SMI and NJI. 


mmrrmmmm - the total number of successful transactions that 
have taken place on the identified link since the 
last similar message was issued, or since the the 
link was initially activated. 

mnnnnnnn - the total number of transactions that have ended 
in error since the last similar message was issued, 
or since the link was initially activated. 

Pppppppp - the total number of time-outs that have occurred 
while waiting for response from the remote station 
Since the last similar message was issued, or since 
the link was initially activated. 


System Action: Normal VNET processing continues. 


Operator Action: The trace function is intended to provide 
some informraticr concerning the state of communications on 
the link for use by installation personnel in diagnosing and 
correcting proklems with communication hardware. If the 
trace information seems to indicate serious malfunctioning, 
corrective action should ke taken. Corrective action might 
include dropping and redialing a switchable telecommunication 
port, deactivating and restarting a link using a different 
port, or reporting the difficulty to support and maintenance 
personnel. 


LINE ‘vaddr' LISABLFD FOR LINK !linkid' 


Explanation: Communication exchange by the link identified by 
"linkid' on the line identified by ‘vaddr' has heen 
terminated, and the line has been disabled. If the line in 
use is a switchakle line, this means that the line has been 
disconnected. 


This message may ke issued during normal frocessing as a 
result of a spontaneous line disconnection. It is always 
issued during the process of link deactivation. 


System Action: If link deactivation is in process, it 
continues normally. Otherwise, the line driver will 
automatically reinitialize and reenable the line, allowing a 
Switchable line to ke redialed. File processing for the link 
is suspended. 


Operator Action: None. 
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FROM ‘locid': (message text) 


Explanation: The character string included in the message as 
(message text) has keen received from the remote location 
identified by ‘locid', and is addressed to the recipient. 
The message originated either from automatic remote system 
processing, or frem the remote VNET operator. 


System Action: Normal VNET processing continues. 


Operator Action: If the message originated from a remote VNET 
operator and the recipient wishes to respond, the response 
message should ke addressed as: MSG 'locid' VNET (response 
message text). 


FROM ‘locid' (tuserid'): (message text) 


Explanation: The character string included in the message as 
(message text) has keen received from a user identified by 
‘userid! at the location identified by ‘locid', and is 
addressed to the message recipient. The special keyword VNET 
appears as tke ‘userid field when the message origin is VNET 
operator console. 


System Action: Normal VNET processing continues. 


Operator Action: None. 


INVALID SPOOL RLOCK FORMAT ON FILE ‘spoolid' 


Explanation: VM/37C spool control or data information 
contained in the file identified by 'spoolid' has been found 
to be in error at the local installation. 


System Action: The error condition is logged, the identified 
file is automatically purged from the system, and link 
processing continues. 


Operator Action: This message indicates a local VM/370 system 
error. The local VMN/370 system support personnel should be 
notified of this error. 


ACCEPTED BY TASK task‘ 


Explanation: The preceding console command has been processed 
ky the VNET syntax scanner and first level semantic 
processor, and a command element has been built. That 
command element has been made available to the task named 
'task', and that task has accepted the command element for 
second level semantic processing. 


System Action: Command semantic processing continues at the 
task named ‘task’. Further response to the ccmmand will be 
issued from that task. 


Operator Action: None. 
REJECTED BY TASK ‘task! -- PREVIOUS COMMAND. ACTIVE 
Explanation: The preceding console command has been processed 


by the VNET syntax scanner and first level semantic 
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processor. A command element has been built and made 
available to the task named ‘task', but that task was unable 
to accept the command element for further processing because 
a previously issued command was still being actively 
processed. 


System Action: The command execution is terminated, the 
command has no effect, and normal processing continues. 


Operator Action: The command may be retried. Command 


POE aD SS ae ee a * 


execution will ke successful when previous command processing 
is complete. 


LINK 'linkid' IS NOT CEFINED 


Explanation: The syntactically valid link ID identified by 
‘linkid' was entered in the preceding console command, but no 
such link is defined with that ID and the command issued 
requires a defined link ID. 


System Action: The command execution is terminated, the 
command has no effect, and normal processing continues. 


Operator Action: Check to see if the link ID was specified as 
intended. If it was incorrectly typed, retry the command 
with a correct link ID. If it was correctly typed, you must 
define the specified link in a VNET DEFINE command or ina 
LINK statement in the VNET directory before the command can 
be executed. 


IINK *linkid' IS NOT ACTIVE 


Explanation: The link identified by ‘linkid' was specified in 
the preceding command, but the link is inactive and the 
command requires specification of an active link. 


System Action: The command execution is terminated, the 
command has no effect, and normal processing continues. 


Operator Action: Check to verify that the command was entered 
as intended. The ccmmand may ke retried if it was 
incorrectly entered, or the specified link may he activated 
prior to command retry. 


REJECTED BY TASK ‘task! -- NOT RECEIVING 


Explanation: Processing of the preceding command could not ke 
completed because the second level processing task named 
'task' refused to accept the command service request from the 
REX task. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Repeated occurrences of this message 


indicate a system error, and VNET system support personnel 
should be notified. 
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Explanation: A previous MSG or CMD command was addressed by 
its originator such that it would have been transmitted on 
the link identified ky ‘linkid'. This means either that the 
command's destination location address was the link's 
location (identified by ‘linkid'), or that the destination 
location was routed by the local VNET system via that link. 
At the time the ccmmand was presented to the link's line 
driver for transmission, the line driver was unable to 
successfully ccmmunicate with the remote station due to 
telecommunications hardware or remote system malfunctions. 


System Action: The message or command is discarded, and 
normal VNET processing continues. 


Operator Action: The link's telecommunications hardware 
should be inspected for any indications of line disconnection 
or malfunction. When the rfroklem has keen corrected, normal 
processing will begin automatically, and the response message 
to a QUERY ‘locid' command will say ‘CONNECT! rather than 
"ACTIVE'. The CMC or MSG command may ke retried when the 
link has been reconnected. 


FILE *spoolid' EACKSPACED 

Explanation: The file identified by ‘spoolid' has been 
tackspaced accordirg to the request in the previous BACKSPAC 
command. 


System Action: File transmission continues, beginning from 
the new file pcsition. 


Operator Action: None. 


NO FILE ACTIVE ON LINK 'linkid' 

Explanation: A valid command for active files was issued to 
the link identified by 'linkid', but no file was being 
actively transmitted on the link at the time of command 
execution. 


System Action: Normal link processing continues, and the 
command has no effect. 


Operator Action: The command may Le retried if it was entered 
in error. 


VALID COMMAND RECOGNIZED ON LINK ‘linkid' -- NO ACTION TAKEN 
Explanation: A valid VNET command has been recognized on the 
link specified ky 'linkid'. The command could. not be 
executed by VNET due to line driver implementation 
restrictions. 

System Action: Normal VNET processing continues. 


Operator Action: None. 
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LINK *linkid!’ NOW SET TO CEACTIVATE 


Explanation: In response to the DRAIN command, the link 
identified by ‘linkid' has set drain status and will be 
deactivated. If the VNET operator issues the START command 
before the link is deactivated, drain status will be reset 
and processing will centinue on the link. 


System Action: If the line driver is not in active 
communication with the remote station at the time of DRAIN 
command executicn, the link is deactivated immediately. 
Otherwise, action is taken to quiesce line activity. This 
includes the finishing of transmission for an active file if 
one exists, and it may include the signaling to the remote 
Station of an impending termination. File reception is 
completed for a file which is being actively received. No 
new files are activated for transmission or accepted for 
reception while the link is in drain status. When line 
activity is quiesced, the link deactivates. 


Operator Action: If the DRAIN command fails to deactivate the 
link within a reasonakle period of time, a FORCE command may 
be issued to deactivate the link unconditionally, regardless 
of actual line activity. 


LINK "linkid' ALREALY SFT TO DEACTIVATE 


Explanation: A CRAIN command was executed specifying the link 
identified by ‘linkid', which was already in drain status as 
the result of a previous DRAIN command. 


System Action: The line driver continues its attempts to 
quiesce the line, and the command has no effect. 


SSP cern [See 


link within a reasonakle period of time, the FORCF command 
may be executed to immediately deactivate the link, 
regardless of line activity. 


FILE 'spoolid' PROCESSING TERMINATED 


Explanation: Transmission of the active file identified Ly 
'‘spoolid' has keen terminated before the completion of file 
processing. This message is issued either in response to a 
FLUSH command, or automatically when a remote system is 
restarted. | 


System Action: [isposition of the identified file is made 
according to the status of the file. The file may be purged 
from the system, or the file may be held for future 
retransmission. If a FLUSH command was entered, the next 
copy of the file may begin transmission if multiple copies 
remain and ‘ALII' was not specified. Normal link processing 
continues. 


Operator Action: None. 
FILE 'spoolid' NOT ACTIVE 


Explanation: This message is in response to a VNET command 
which requires specificaton of an active file as the 
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command's object. At the time of command processing, the 
spoolid specified in the ccmmand ('spoolid') was not active. 


System Action: The command has no effect, and normal link 
processing continues. 


Operator Action: The status of a file may be determined by 
issuing a QUERY FILE ‘spoolid' command. The command may be 
retried if it was entered in error. 


DMTxxx590I LINK 'linkid' RESUMING FILE TRANSFER 


Explanation: The active link identified by ‘linkid' was in 
hold status, and has keen removed from hold status in 
response to FREE command processing. 


System Action: File transmission on the identified link 
resumes automatically when a file eligible for transmission 
is available. 


Operator Action: None. 


DMTxxx591E LINK 'linkid' NOT IN HOLD STATUS 
Explanation: The link identified by ‘linkid' was not in hold 
status when a FREE command was processed requesting that the 
link leave hold status. 


System Action: The command isS ignored, and normal link 
processing continues. 


Operator Action: None. 


DMTxxx600I FILE ‘spoolid! FORWARD SPACED 


Explanation: The file identified by ‘spoolid' has been 
forward spaced as requested Ey a preceding FWDSPACE command. 


System Action: File transmission continues, beginning from 
the new file feosition. 


Operator Action: None. 


DMTxxx610I LINK 'linkid' TO SUSPEND FILF TRANSMISSION 
Explanation: The link identified by ‘linkid' has entered hold 
status. File transmission has not been suspended because at 
the time of ccmnand processing a file was being actively 
transmitted, and the "IMMEL' option was not specified. 
System Action: The link remains in hold status. File 


transmission will be suspended when the processing of 
currently active output files has been completed. 


DMTxxx611I LINK ‘linkid' FILE TRANSMISSION SUSPENDED 


Explanation: This message is in response to HOLD command 
processing. The link identified by ‘linkid' has entered hold 
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status, and file transmission has been halted. Either no 
file was being actively transmitted at the time of command 
processing, or the link had keen in hold status and its 
active file trarsmission has completed, or an active file was 
being transmitted and the "IMMFD* operand was specified. 


System Action: The link remains in hold status, and file 
transmission remains suspended until the link is explicitly 
freed from hold status. If active file transmission was 
interrupted, the transmission of the active file resumes from 
the point at which transmission was interrupted, when the 
link is removed from hold status. The link continues to 
process files received from the remote station normally while 
in hold status. 


Operator Action: None. 


LINK 'linkid' ALRFALY IN HOLD STATUS 


Explanation: This message is issued in response to HOLD 
command processing. The command requested that the link 
specified by ‘linkid' ke placed in hold status. The link was 
already in held status at the time of command processing. 


System Action: The link remains in hold status, and the 
command has no effect. 


Operator Action: None. 


LINK 'linkid' LOG ACTIVATEL 


Explanation: This message is issued in response to a TRACE 
"linkid' LOG command. The specified link's log trace had 
been inactive pricr to command processing, and now has been 
activated. 


System Action: While log trace is active for a link, a record 
of each line IyoO transaction is written to a spool print 
file. Each record contains the channel program executed, the 
composite CSW, the ending sense data if any, and the 
keginning and ending data string from each buffer used. The 
spool file is queued for real printer output when the log 
trace is deactivated for the link. 


Operator Action: None. 


LINK ‘linkid' LOG CEACTIVATED 


Explanation: This message is issued in response to a TRACE 
"linkid' NOLOG command. The specified link's log trace had 
keen active prior to command processing, and now has been 
deactivated. 


System Action: Logging of each line I/0 transaction is 
terminated, and the spool print file log of prior 
transactions is closed and engqueued for real printer 
processing. 


Operator Action: This function is intended to provide system 


support personnel to obtain diagnostic information concerning 
telecommunication system behavior. When communication on a 
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particular link appears to be malfunctioning, a log trace may 
be prepared and sukmitted to the support personnel. 


LINK 'linkid' SUM REPORTING CEACTIVATED 


Explanation: This message is issued in response to a TRACE 
‘linkid*' NOSUM command. The specified link had been in sum 
trace mode prior to command processing, and has now left sum 
trace mode. 


System Action: No further sum trace messages will be issued, 
and normal link processing continues. 


Operator Action: None. 


LINK *linkid' LOG ALREADY ACTIVE 


Explanation: This message is issued in response to a TRACE 
'linkid' LOG command. The command requested that the 
specified link enter log trace mode, and the link had already 
been in log trace mode at the time of command processing. 


System Action: The link remains in log trace mode, the 
command has no effect, and normal link processing continues. 


Operator Action: None. 


LINK *linkid' LCG NOT ACTIVE 


Explanation: This message is issued in response to a TRACE 
‘linkid' NOLOG command. The command requested that the 
specified link leave log trace mode, and the link had not 
been in log trace mode at the time of command processing. 


System Action: Log trace remains inactive for the link, the 
command has no effect, and normal link processing continues. 


Qperator Action: None. 


LINK *linkid' SUM REPORTING ALREALY ACTIVE 


Explanation: This message is issued in response to a TRACE 
‘linkid' SUM ccmmand. The command requested that the 
specified link enter sum trace mode, and the link had already 
been in sum trace mode at the time of command processing. 


System Action: The link remains in sum trace mode, the 
command has no effect, and normal link processing continues. 


Operator Action: None. 


LINK *linkid' SUM REPORTING NOT ACTIVE 


Explanation: This wessage is issued in response to a TRACE 
‘linkid' NOSUM command. The command requested that the 
specified link leave sum trace mode, and the link had not 
been in sum trace mode at the time of command processing. 


System Action: Sum trace remains inactive for the link, the 
command has no effect, and normal link processing continues. 


Reference and Operations 


DMTxxx902E 


DMTxxx903E 


DMTxxx904E 


DMTxxx905I 


Operator Action: None. 


NON-SIGNON CART READ ON LINK 'linkid' 


Explanation: The link identified by 'linkid' had not been 
signed on, and a record received from the remote station was 
not a SIGNON card, contrary to line driver operational 
requirements. 


System Action: The link remains active but not signed on, and 
file, command, and message exchange for the link remains 
suspended pending successful sign-on. 


Operator Action: Any errors present on the sign-on card 
should be corrected, and the sign-on procedure should be 
retried. 


PASSWORD SUPPLIED ON LINK 'linkid' IS INVALID 


Explanation: An attempt to Sign-on a remote station has 
failed because the password entered on the SIGNON record does 
not match the password specified by the operator when the 
remote station's link, identified by 'linkid', was started. 


System Action: The link remains active but not signed on, and 
file, command, and message exchange for the link remains 
suspended pending successful sign-on. 


Operator Action: Any errors present on the SIGNON card should 
be corrected, and the sign-on procedure should ke retried. 
If the problem persists, the operations personnel at both 
ends of the link should establish an agreed upon password. 


SIGNON PARAMETER="parm' ON LINK ‘linkid' INVALID 


Explanation: A sign-on record for the link identified by 
'linkid' contained the invalid parameter identified by 

e t 

parm’. 


System Action: The link remains active but not signed on, and 
file, command, and message exchange for the link remains 
suspended pending successful sign-on. 


Operator Action: Any errors present on the sign-on card 
should be corrected, and the sign-on procedure should be 
retried. 


SIGNON OF LINK "linkid' COMPLETE 


Explanation: A valid SIGNON record has been received on the 
link identified by ‘linkid', and the link sign-on procedure 
has been successfully completed. 


system Action: Exchange of files, ccmmands, and messages is 
automatically begun on the identified link. 


Operator Action: If the remote station is a bulk terminal, 


normal operational precedures should be followed for sending 
input files and receiving output files. 
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DMTxxx913E 


DMTxXxx914E 


DMTxxx91 8E 


DMTxxx9 19E 


168 VWNET 


INVALID PASSWORC PARAMETER SPECIFIED -- LINK 'linkid'! NOT 
ACTIVATED 


Explanation: Curing initial processing immediately following 
link activation, the line driver encountered an invalid 
password specification. 


System Action: The specified link is automatically 
deactivated. 


Operator Action: The START command may ke retried specifying 
a valid password. If the problem persists, local VNET system 
suprort personnel should ke notified. 


INCORRECT PASSWORD RECEIVED ON LINK 'linkid' 


Explanation: A valid password parameter received in a SIGNON 
record from the remote system did not match the local link 
password in effect at the time. 


System Action: The line driver executes its disconnect 
sequence. Dependent on the line driver in use, the line may 
be re-enabled or the link may be automatically deactivated. 


Operator Action: The problem should be communicated to those 
responsible for syster support at the remote location. If 
the problem persists, the rfroklem should be reported to 
personnel responsikle for local VNET system support. 


LINK *linkid' COES NOT MATCH REMOTE LOCATION ‘locid' 


Explanation: A SIGNON record received from the remote system 
specified a location ID 'locid' which was not the same as the 
link ID *linkid' for the line driver in use at the local 
location. The link ICD is defined as the location ID of the 
directly connected renote location. 


System Action: The line driver executes its disconnect 
sequence. Dependent on the line driver in use, the line may 
be re-enabled or the link may be automatically deactivated. 


Operator Action: The problem should be communicated to 
personnel resronsible for local VNET system support. 


SIGNON SEQUENCE ON LINK ‘linkid' FAILED 

Explanation: 

(a) Data was received from the remote system before a SIGNON 
record was successfully received and accepted. 

(b) An unrecoverable line error occurred during signon 
sequence. 

(c) An incorrect password or location ID was detected at the 
remote system. 

(d) The remote systen is incompatible with the line driver 
in use. 

Reference and Orferations 


System Action: The line driver executes its disconnect 
sequence. Dependent on the line driver in use, the line may 
ke re-enabled or the link may be automatically deactivated. 


Operator Action: The problem should be communicated to 
personnel responsikle for local VNET system support. 


DMTxxx934E ID CARD MISSING ON LINK ‘linkid' -- INPUT FILE PURGED 


Explanation: A file has been entered at a remote station 
without an ID card specifying the destination. 


System Action: The input file is flusked, and norral 
processing continues. 


Operator Action: An IL card should be placed at the beginning 
of the input file deck, or errors in an existing ID card 
should be corrected, and the file input operation should be 
retried. The operational procedures for the remote terminal 
and line driver in use should be consulted to determine 
format requirements for the input file ID card. 


VNET MESSAGE SUMMARY 


The message codes listed ccnform to VM/370 standards. The first three 
characters (DMT) denote the VM/370 Networking PRPQ (VNET). The next 
three characters denote the module origin of each message; the possible 
codes are REX, CMX, AXM, INI, NPT, SML, VMB, VMC, NCM, NHD and NIT. 
Some messages can be issued by more than one module. These messages 
appear in the Summary with the fourth, fifth, and sixth characters 
encoded as xxx. However, when the message is issued, xxx will be 
replaced with the appropriate module code. The next three characters 
contain the message number. The last character is a message severity 
code and consists of the following: 


response messsageé 

informational message 

error message 

terminal error -- system shutdown 
severe error message 


ON + BH oo 


The key to the left of the ressage codes indicates the possible 
destinations of each message; the column headings are as follows: 


VNET - VNET local oferator's console 
ORIG Cormand originatcr 

VMID - Virtual machine user 

CPOP VM/370 CP operator 
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VNET SPONTANEOUS MESSAGES 


IHinwd 
lInaHwWoO 


mi OS Ox 


MS OS OS OOM 
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lp He 


lv oun 


VNET Spontaneous Messages 


DMTIRXOOOI 
DMTCMXO001I 
DMTREXOO021 
DMTCMXO0O03I 
DMTCMXOO4T 
DMTCMXOO5I 


DMTxxx070E 
DMTREXO80E 
DMTREXO090T 
CMTREXO9IT 
DMTAXM101I 
DMTAXM102T 
DMTAXM103E 


DMTAXM1041 


DMTAXM105I 
DMTAXM106TI 


DMTAXM1071I 
DMTxxx108E 
DMTAXM109I 
DMTAXM111E 


DMTxxx141I 
DMTxXxx142TI 
DMTxxx143I1 
DMTxxx144T 
DMTxxx145I 
DMTxxx146I 
DMTxxx147I 
DMTxXxx148TI 
DMTxxx 1491 
DMTxxx160I 
DMTxxx17CI 
DMTXxXx171I 


DMTxxx190E 
DMTIRX4OOIL 


VNET VER v, LEV 1, mm/dd/yy 
FREF STORAGE = ‘nn PAGES 
LINK *linkid' DEACTIVATED 
LINK *linkid' EXECUTING: (command line text) 
LOCATION tlocid' EXECUTING: (command line text) 
LOCATION tlocid' (userid!) EXECUTING: (command line 
text) 

I/O ERROR cuu SIOCC cc CSW csw SENSE sense CCW ccw 
PROGRAM CHECK -- LINK 'linkid' DFACTIVATED 

PROGRAM CHECK IN SUPERVISOR -- VNET SHUTDOWN 
INITIALIZATION FAILURE -- VNET SHUTDOWN 

FILE "spoolid’ (*orgid') ENQUEUED ON LINK ‘linkid' 
FILE 'spoolid! (‘orgid') PENDING FOR LINK 'linkid' 


READY 


FILE 'spoolid' ("‘orgid') REJECTED -- INVALID 
DESTINATION ADDRESS 
FILE ('orgid') SPOOLED TO ‘userid1! -- ORG 'locid' 


(userid2) mm/dd/yy hh:mm:ss 

FILE 'spoolid' PURGED 

FILE *‘spoolid' MISSING -- DEQUEUEFD FROM LINK 
'linkid' 

'nn' PENDING FILES FOR LINK ‘linkid' MISSING 
SYSTEM ERROR REALING SPOOL FILE ‘'spoolid' 

FILE QUEUE REORCERED 

USER ‘userid! NOT IN CP CIRECTORY -- FILE ('orgid') 
SPOOLELC TO SYSTEM 

LINE ‘vaddr' REACY FOR CONNECTION TO LINK ‘'linkid!' 
LINK ‘linkid' LINE ‘vaddr' DATASET READY 

LINK 'linkid' LINF 'vaddr' DISCONECTED 

RECEIVING FILE ('orgid') ON LINK 'linkid' FROM 
"locid® ("userid'), REC nnnnnnnn 

RECEIVEL FILF (‘'orgid') ON LINK ‘linkid' TO 'locid! 
‘userid!’ 

SENDING FILE ‘spoolid' (‘torgid') ON LINK FROM 
‘locid' ‘userid! 

SENT FILE ‘spoolid' ('orgid') ON LINK ‘linkid' TO 
"‘locid' ‘userid! 

ACTIVE FILE 'spoolid! SENDING RESUMED ON LINK 
'linkid' 

LINK *linkid' LINE ACTIVITY; TOT= mmmmmmmm; FRRS= 
nnnnnnnn; IMOUTS= pppppppp 

LINE ‘vaddr' DISABLFL FOR 'linkid' 

FROM ‘linkid': (message text) 

FROM 'linkid'(*userid'): (message text) 

INVALICL SPOOL BLOCK FORMAT ON FILE ‘'spoolid' 

VNET DIRECT mm/dd/yy hh:smm,'nn! MAX 

ACTIVE LINKS, 'tt* TAGS 


VNET Reference and Oferations 


<I bw <i 
IQ HwoO 


a 


~ 


lO H = <i 


Ceo m.cm@) 


DMTxxx580I 
DMTNHIIY10E 


DMTNHC9I171 
DMTxxx934E 
DMTSML9Y35E 


DMTNPT936E 


CCMMAND RESPONSES 


PS PS PS OS DS OS DS OOS OS OS OG OS OM 


PS PS PS OS PS OOS ODS OS OS 


PS oS 


FILE ‘'spoolid' PROCESSING TERMINATED 


INVALIC NJI PARAMETER ‘parm' ON TAG -- PARAMETER 
IGNOREL 
NII LINK ‘linkid': (JOB|OUTPUT) (‘orgid'), JOBRNAME 


'job', PGMR ‘user' 

ID CARD MISSING ON LINK 
PURGEL 

LINK ‘linkid' IN RJE MODE -- PRINT FILE 'spoolid' 
PURGELC 

NO REMOTE PUNCH AVAILABLE ON LINK 
"spoolid' PURGED 


"linkid' -- INPUT FILE 


*linkidt -- FILE 


General Command Responses 


CMTCMX200I 
DMTCMX201E 
DMTCMX202E 
DMTCMX203E 
DMTICMX204E 
DMTCMX205E 
DMTCMX206E 
DMTCMX207E 
DMTCMX208E 
CMTCMX209E 
DMTCMX210E 
CMTxxx3001 
DMTIxxx301E 


DMTxxx302E 
DMTxxx303E 
DMTxxx304E 
DMTCMX310F 
DMTxxx320E 
CMTRGX330E 
CMTRGX331E 
DMTRGX332E 
DMTxxx531I 


VNET 

INVALIC COMMAND ‘'command' 

INVALIC LINK ‘linkid' 

INVALID SPOOL ID ‘spoolid' 

INVALIC KEYWORD 'tkeyword' 

CONFLICTING KEYWORD ‘keyword'! 

INVALIC CPTION ‘keyword! ‘option’ 
CONFLICTING OPTION ‘keyword! ‘option!’ 
INVALIC USER ID ‘tuserid' 

RESTRICTED COMMAND tcommand' 

INVALIC LOCATION tlocid' 
ACCEPTED RY TASK ‘'task'* 
REJECTELC BY TASK ‘task'* 
CCMMANCT ACTIVE 
LINK tlinkid' IS 
LINK *linkid' IS 
REJECTELC PY TASK 
LOCATION tlocid! IS NOT DEFINED 
LINK "linkid' NOT CONNECTED 
USERIC MISSING OR INVALID 
‘userid! NOT LOGGED ON 

"userid' NOT RECEIVING 

VALIL COMMAND RECOGNIZED ON LINK 
NO ACTION TAKEN 


== (PREVIOUS 


NOT DEFINED 
NOT ACTIVE 
'task' NOT RECFIVING 


“lankad* 


Specific Command Responses 


PACKSPAC: 


DMTxxx510I 
DMTxxx511E 


CHANGE: 


CMTAXM5201 
DMTAXM521I 
DMTAXM5221 


FILE 'spoolid' 
NO FILE ACTIVE 


BACKS PACED 
ON LINK 'linkid' 


FILE *spoolid' 
FILE 'spoolid' 
FILE 'spoolid' 


CHANGED 
HEID FOR LINK ‘linkid' 
RELEASED FOR LINK 'linkid' 
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rar a < 


mS OS OS 


PS OS OS OS OOS 


mS PS DS 


mM 
m6 OS 


lA HwO 


> OX 


mM OS OX 
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IODH ze 


igomwn 


Specific Command Responses 


DMTAXM5231 
DMTAXM524E 
DMTAXM525E 


DMTAXM526E 


CLOSE: 


DMTAXM500I 
DNTAXM501E 
CMTAXM5SO2E 


CMC: 


DMTxxx302E 
DMTxXxx303E 
DMTCMX310E 
DMTxXxx320E 


DEFINE: 


CMTCMX5S40I 
CMTCMX5411 
DMTCMX542E 
DMTCMX543E 
CMTCMX6531 


c Z=z R=r 


DELETE? 
CMTCMX550I 


CMTCMX551E 
DMTCMX552E 


DISCONN: 


CMTCMX560T 
CDCMTCMX561F 


CRAIN: 


DMTxxx5 701 
DMTxxx571E 


LINK *linkid* QUEUE REORCERED 

FILE *spoolid' ACTIVE -- NO ACTION TAKEN 
FILE ‘spoolid' IS FOR LINK 'linkid'! -- 

NO ACTION TAKEN 

FILE *spoolid' NOT FOUND -- NO ACTION TAKEN 


nn FILE(S) CLOSED ON LINK ‘linkid' 
LINK *linkid* ACTIVE -- NO FILE(S) CLOSED 
FILE 'spoolid' INACTIVE -- NO ACTION TAKEN 


LINK *linkid' IS NOT DEFINED 
LINK "linkid' IS NOT ACTIVE 
LOCATION ‘locid' IS NOT DEFINED 
LINK *linkid' NOT CONNECTED 


NEW LINK ‘linkid' DEFINED 

LINK *linkid' RECEFINED 

LINK *linkid' ACTIVE -- NOT REDEFINED 

LINK "linkid' NOT DEFINED -- LINK LIMIT REACHED 


LINK ‘linkid' DEFAULT 'task' ‘type ‘vaddr' 


LINK ‘linkid' NOW DELETED 
LINK "linkid' ACTIVE -- NOT DELETED 
LINK *linkid' HAS A FILE QUEUE -- NOT DELETED 


VNET CISCCNNECTING 
USERID ‘userid' NOT RECEIVING 


LINK ‘linkid' NOW SET TO DEACTIVATE 
LINK "linkid' ALREADY SET TO CEACTIVATE 


VNET Reference and Operations 


lIYWmwad 


mS OS OS 
PS PS 


IQ HwOoO 


mS OS OO OO OX 


IOH =@e 


IW~oun 


Specific Comrand Responses 


EXEC: 

CMTCMX675E 
DMTCMX676E 
DMTCMX677E 
CMTCMX678E 


DMTREX6791 


FLUSH: 


DMTxxx580I 
DMTxxx581E 


FORCE: 


DMTREXOO02T 


FREES 


DMTxxx590I 
DMTxxx591E 


FWDSPACE=: 


CMTxxx600T 
DMTxxx511E 


HOLD: 


DMTxxx610I 
DMTxxx611TI 
CMTxxx612E 


MSG: 


DMTXxXx302E 
DMTxxx303E 
DMTCMX310E 
DMTxxx320F 
CMTRGX330E 
CDMTRGX331E 
DMTRGX332E 


EXEC 'filenamet NCT FOUND ON DISK ‘vaddr' -- 
COMMAND FILE NOT EXECUTED 

FATAL EREFOR READING FROM 'vaddr' -- EXEC 
'filenare' PROCESSING TERMINATED 


EXFC *filenamet FILE FORMAT INVALID -- 
EXEC NOT EXECUTED 

EXEFC 'filenamet IN EXECUTION -- 
COMMANLC IGNORED 
EXECUTING ‘filename! 


NEW EXEC 


COMMAND: (command line) 


FILE 
FILE 


PROCESSING TERMINATED 
NOT ACTIVE 


"spoolid' 
"spoolid' 


LINK *tlinkid* DEACTIVATED 


*linkid' 
"linkid't 


LINK 
LINK 


RESUMING FILE TRANSFER 
NOT IN HOLD STATUS 


FILE 'spoolid' FORWARD SPACED 
NO FILE ACTIVE ON LINK 'linkid' 


LINK 
LINK 
LINK 


‘linkid' 
tlinkid'* 
"linkid' 


TO SUSPEND FILE TRANSMISSION 
FILE TRANSMISSION SUSPENDED 
ALREADY IN HOLD STATUS 


LINK ‘linkid' IS NOT DEFINED 
LINK ‘linkid' IS NOT ACTIVE 
LOCATION tlocid' IS NOT DEFINED 
LINK *linkid' NOT CONNECTED 
USERID MISSING OR INVALID 
‘userid* NOT LOGGED ON 


"userid' NOT RECEIVING 
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ldmawe 
IA HwWOo 


OS 
mS OS 


mS OS DS OOS 
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lOH =e 


Ivonuwn 


Specific Command Responses 


ORDER =: 


DMTAXM523I LINK ‘linkid' QUEUE REORDEREDLC 

DMTAXM524E FILE 'spoolid' ACTIVE -- NO ACTION TAKEN 

DMTAXM525EF FILE ‘spoolid' IS FOR LINK 'linkid' -- 
NO ACTION TAKEN 


DMTAXM526E FILE ‘spoolid't NOT FOUND -- NO ACTION TAKEN 
PURGE: 
DMTAXM524E FILE 'spoolid'! ACTIVE -- NO ACTION TAKEN 


DMTAXM525E FILE 'spoolid' IS FOR ‘linkid' -- 

NO ACTION TAKEN 
DMTAXM526E FILE 'spoolid' NOT FOUND -- NO ACTION TAKEN 
DMTAXM640I 'nn!' FILE(S) PURGED ON LINK ‘linkid' 


QUERY 'locid': 

DMTCMX6361I ‘locid't ROUTED THROUGH LINK ‘'linkid' 
DMTCMX6371I tlocid! NCT ROUTED 

DMTCMX6511I LINK 'linkid't INACTIVE 


DMTCMX652I LINK 'linkid' (CONNECT|ACTIVE) 'task' ‘type! 
'vaddr' c (HO|NOH) (CR|NOD) (NOT| TRS|TRL|TSL) 


QUERY ‘linkid'! ACTIVE: 
DFETCMX656I FILE ‘spoolid! (‘orgid') ‘locid' ‘userid' 


CL a PR pp LEFT mmemmmmmm OF nnnnnnnn 
DMTCMX665I NO FILE ACTIVE 


QUERY 'linkid' DEF: 


CMTCMX653I LINK ‘linkid' DEFAULT ‘task' ‘type 'vaddr' 
c Z=z R=r 


QUERY ‘linkid' FILES; 


DMTCMX6541T LINK ‘linkid' S=s R=r Q=q P=p 


QUERY 'linkid! QUEUE: 


DMTCMX654T LINK ‘linkid' S=s R=r Q=q P=p 
DMTCMX655I FILE ‘spoolid'! ('orgid') ‘locid' ‘userid' 
CL a PR pp REC nnnnnnnn (HO| NOH) 


VNET Reference and Operations 


Im w < 


IQS vw O 


PS PS 


OX 


lOH =e 


Imomun 


Specific Command Responses 


QUERY *linkid*® SUM; 


DMTCMX149I LINKIC *linkid' LINE ACTIVITY; TOT=mmmmmmmm; 
ERRS=nnnnnnnn; 


TMOUTS=pppppppp 


QUERY FILE 'spoolid'! STAT: 


DMTCMX660I FILE ‘spoolid' INACTIVE ON LINK 'linkid!' 
DMTCMX661I FILE ‘spoolid' ACTIVE ON LINK 'linkid' 
DMTCMX664E FILE 'spoolid' NOT FOUND 


QUERY FILE ‘spoolid’ VM: 


CMTCMX6631 FILE 'spoolid' PR pp CL a CO nn (HO|NOH) 
DI ‘distcode', NA ("fn ft'|'dsname') 
DMTCMX664E FILE 'spoolid! NOT FOUND 


QUERY FILE 'spoolid! VNET: 


DMTCMX662T FILE 'spoolid' ORG 'locid1!' ‘userid1' 
ORGID ‘orgid' mm/dd/yy hh:mm:ss z.z.Z. 
TO "locid2!* ‘userid2' 

DMTCMX664E FILE *spoolid' NOT FOUND 


QUERY SYSTEM ACTIVE: 


CMTCMX67CI LINK *linkid' (CONNECT|ACTIVE) -- LINE 
'vaddr' (HO|{NOH) (DR|NDR) (NCT|TRS|TRL|TSL) 
DMTCMX672I NO LINK ACTIVE 


QUERY SYSTEM LINKS: 


DMTCMX670I LINK 'linkid' (CONNECT|ACPIVE) -- LINE 
"vaddr' (HO| NOH) 

DMTCMX671I LINK *linkid' INACTIVE 

DMTCMX673I NO LINK DEFINED 


QUERY SYSTEM PORTS: 
DMTCMX625I NO PORTS AVAILABLE 


CMTCMX626I PORT 'vaddr' AVAIIABLE 
DMTCMX627I PORT ‘vaddr' IN USE BY LINK 'linkid' 
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Inm =e 
la HwWO 


OS OS OX 


mS OM 
PS 
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JOH = < 


Im own 


Specific Command Responses 


QUERY SYSTEM ROUTES: 


CMTCMX6341I 
DMTCMX6 361 


NO LOCATIONS ROUTED 


"locid' ROUTED THROUGH LINK ‘linkid' 


QUERY SYSTEM QUEUE: 


DMTCMX654I 
DMTCMX674T 


REORD: 


DMTAXM109I1 


ROUTE: 

DMTCMX63 01 
DMTCMX6 311 
DMTCMX632E 


DMTCMX633E 
DMTCM X6 38E 


START: 

DMTCMX700I 
DMTCMX701E 
DMTCMX702E 
DMTCMX703E 
DMTCMX7OUE 
DMTCMX705E 
DMTCMX706E 
DMTCMXTO7E 
DMTCMX708E 
DMTCMX709E 
DMTCMX710E 


CMTxxx750E 
DMTCMX751I 


LINK ‘linkid' S=s R=r Q=q P=p 
NO FILES QUEUED 


FILE QUEUE REORDED 


NCW ROUTEC THORUGH LINK ‘linkid' 
"locid' DEACTIVATED 


'locid' 
INDIRECT ROUTING FOR 


"locid' INVALID ROUTE SPECIFIED 
"locid' NOT ROUTED -- ROUTE LIMIT REACHED 
LOCATION ‘locid' HAS A FILE QUEUE -- 


INDIRECT ROUTING NOT DEACTIVATED 


ACTIVATING LINK 'linkid' 'task' 


'vaddr'c 


t type t 


NO SWITCHED LINE AVAILABLE -- LINK 'linkid' 
NOT ACTIVATEL 

LINE ‘vaddr' IS IN USE BY LINK !linkid1! -- 
LINK *linkid2' NOT ACTIVATED 

DEV fcuut IS NOT A LINE PORT -- LINK 'linkid'! 
NOT ACTIVATED 

LINE ‘tvaddr' cc=3 NOT OPERATIONAL -- 

LINK 'linkid! NOT ACTIVATED 

DRIVER 'type' NOT FOUND ON DISK ‘vaddr! -- 
LINK *linkid' NOT ACTIVATED 

FATAL ERROR LOADING FROM ‘vaddr'! -- LINK tlinkid' 


NOT ACTIVATED 
CRIVER ‘type! FILE FORMAT INVALID -- LINK tlinkid' 
NOT ACTIVATEL 


VIRTUAL STORAGE CAPACITY EXCEEDED -- LINK 'linkid' 
NOT ACTIVATEL 

TASK NAME 'task' ALREADY IN USE -- LINK 'linkid' 
NOT ACTIVATED 

MAX ('nn') ACTIVE -- LINK 'linkid' NOT ACTIVATED 
LINK tlinkid* ALREADY ACTIVE -- NO ACTION TAKEN 
LINK 'linkid' ALREADY ACTIVE -- NEW CLASS (ES) 


SET AS REQUESTED 


VNET Reference and Oferations 


Ian we) 


OS PS OG OS OS OS OOS 


a 


a 
mS OS OS OS OOS 


INAHDWO 


lpobH ze 


Iu oun 


Specific Command Responses 


DMTxxx752I 
DMTSMLIOOIE 


DMTSML9YO06E 
DMTNITOI1E 
DMTNIT912E 


DMTNIT913E 


TRACE: 


DMTxxx801I 
DMTxxx802T 
DMTxxx803I 
DMTxXxx810E 
CMTxxx811E 
DMTxxx8 12E 
DMTxXxx813E 


TRANSFER: 


DMTAXM524E 
DMTAXM525E 


DMTAXM526E 
DMTAXM645TI 


LINK *linkid' STILL ACTIVE -- DRAIN STATUS RESET 
INVALIC SML MODE SPECIFIED -- LINK 'linkid' 

NOT ACTIVATED 

INVALIC SML BUFFER PARAMETER -- LINK ‘'linkid' 
NOT ACTIVATEL 

INVALIC NJI EUFFER SIZE SPECIFIEL -- 

LINK *‘linkid' NOT ACTIVATED 

INVALIC NII NODAL RESISTANCE SPECIFIED -- 

LINK *linkid' NOT ACTIVATED 


INVALID PASSWORD PARAMETER SPECIFIED -- 
LINK ‘linkid' NOT ACTIVATED 


'linkid' 
'linkid' 
"linkid' 
'linkid' 
'linkid' 
'linkid' 
'linkid' 


LINK 
LINK 
LINK 
LINK 
LINK 
LINK 
LINK 


LOG 
LOG 
SUM 
LOG 
LOG 
SUM 
SUM 


ACTIVATED 

DEACTIVATED 

REPORTING CEACTIVATED 
ALREACLY ACTIVE 

NOT ACTIVE 

REPORTING ALREADY ACTIVE 
REPORTING NOT ACTIVE 


FILE 'spoolid' 
FILE 'spoolid' 
NO ACTION TAKEN 
FILE ‘spoolid' NOT FOUND -- NO ACTION TAKEN 
‘nn! FILE(S) TRANSFERRED ON LINK 'linkid' 


ACTIVE -- NO ACTION TAKEN 
IS FOR LINK 'linkid' 


Messages Generated Curing the Sign-On Procedure 


SIGNON: 


DMTxxx902E 
DMTxxx903E 
DMTNPTOO4E 
CMTxxx905I 
DMTNPTIOTE 


NON-SIGNON CARD READ ON LINK 
PASSWORD SUPPLIED ON LINK 
SIGNON PARAMETER='parm' INVALID 
SIGNON of LINK ‘linkid' COMPLETE 
SIGNCN TYPE PARAMETER MISSING 


‘linkid' 
‘linkid' IS INVALID 
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vVvove 

N RM P 

Bede 20 

TGDP 

Messages Generated During the Sign-On Procedure 

X DMTxxx913E INVALIC PASSWORD PARAMETER SPECIFIED -- 
LINK ‘linkid' NOT ACTIVATED 

X DMTxXxx914F INCORRECT PASSWORD RECEIVED ON LINK ‘linkid' 

X DMTNCM915E INCOMPATIFLE NJI FPUFFER SIZES -- LINK ‘linkid' 
IS BEING CEACTIVATED 

X DMTNCM916E INVALIC NJI SIGNON CONNECTION RECORD 
RECEIVED -- LINK 'linkid' IS BEING DEACTIVATED 

X CMTxxx918E LINK ‘linkid' DOES NOT MATCH REMOTE LOCATION 
"locid' 

X DMTxxx919E SIGNON SEQUENCE ON LINK 'linkid' FAILEL 
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DS OM DS OS Od OM OD OG OS OG OM 


ra 


DS DS DS OS DE OS DS OR OS OR OS OS DS OG DK OOS OS OS OS OS OOS OOS OO 
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DMTINI4101 
DMTINI4G11R 
DMTINI412R 
DMTINI413R 
DMTINI4G81E 
DMTINI482E 
DMTINI483E 
DMTINI484E 
DMTINI485E 
DMTINI498S 
DMTINIG99T 


DMTIRX449T 


DMTIRX450E 
DMTIRX451E 
DMTIRX452E 
DMTIRX453E 
DMTIRX454E 
CMTIRX455F 
DMTIRX456E 
DMTIRX457E 
DMTIRX458E 
DMTIRX461E 
DMTIRX462E 
DMTIRX463E 
DMTIRX464UE 
DMTIRX4E5E 
DMTIRX466E 
DMTIRX467E 
DMTIRX468E 
CDMTIRX469E 
DMTIRX490T 
DMTIRX491T 
DMTIRX492T 
DMTIRX49 3T 
DMTIRX494T 


NUCLEUS WRITE COMPLETE 

SYSTEM CISK ADDRESS = ccu 

REWRITE THE NUCLEUS ? {YES| NO} 
NUCLEUS CYL ADDRESS = nnn 

INVALIC CEVICE ADDRESS -- REENTER 
INVALID CYLINDER NUMBER -- REENTER 
INVALIEC REPLY -- ANSWER "YES" OR "NO" 
IPL DEVICE ERROR -- REENTER 
CYLINDER IN USE FOR CMS FILES 

IPL CEVICE WRITE I/0 ERROR 

IPI CEVICE READ I/0 ERROR 


MAX TAGS REQUEST OF 1 PER VIRTUAL 
STORAGE K ASSUMED 

INVALIC CIRECTORY ENTRY 

DIRECTORY ENTRY OUT OF ORDER 
LOCAL PREVIOUSLY SPECIFIED 

PARM PREVIOUSLY SPECIFIED FOR LINK 
TAGS PREVIOUSLY SPECIFIED 
DUPLICATE LOCATION ID 

DUPLICATE LINK ID 

DUPLICATE PORT ADDRESS 

UNCEFINEL LINK ID 

LOCATION ID MISSING OR INVALID 
LINK ID MISSING OR INVALID 
INVALID CRIVER SPECIFICATION 

PORT ADDRESS MISSING OR INVALID 
INVALID ZONE SPECIFICATION 
INVALID TASK SPECIFICATION 
INVALID CLASS SPECIFICATION 
INVALID KEEP SPECIFICATION 

TAGS COUNT MISSING OR INVALID 
UNSUPPCRTEL SYSTEM RESIDENCE CEVICE 
FATAL ERROR READING VNET DIRECT 
FATAL ERRCR LOACLING CMTAXS 

FATAL ERROR LOADING DMTLAX 

LOCAI LOCATION DEFINITION MISSING 
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VNET WAIT STATE CODES 


When VNET enters a wait state, the VNET operator is notified via the CP 
message: 


DMKDSP450W CP ENTFRELC; CISABLED WAIT PSW 


issued to the VNET operator's console. USing CP commands, the operator 
can display the virtual machine's PSW. The three rightmost hexadecimal 
characters indicate the error condition. 


001 


007 


011 


Explanation: If no VNET message was issued, a program check 
interrupt has occurred during the execution of the program check 
handler. The prokakle cause iS a programming error. If the VNET 
message: 


DMTREX091T INITIALIZATION FAILURE -- VNET SHUTDOWN 


was issued, VNET operation has been terminated Lecause of an error 
in the loading of DMTAXS or DMTLAX. A dump of virtual storage is 
automatically taken. Verify that the CMS files DMTAXS TEXT and 
DMTLAX TEXT are correctly written and resident on the VNET system 
residence device. If the VNET message: 


DTMREXO90T PROGRAM CHECK IN SUPERVISOR -- VNET SHUTCOWN 


was issued, the program check handler has terminated VNET due to a 
program check interrupt in other than a dispatched line driver. 
The prokakle cause iS a programming error. 


The wait state code is loaded by DMTREX at VNET termination or 
autcratically during program check handling. 


Operator Action: If neither of the akove two messages was issued, 
use the CP DUMP command to dump the contents of virtual storage. 
IPL to restart. If the problem persists, notify your system 
support personnel. 


Explanation: A program check interrupt has occurred during initial 
processing, before the program check handler could be activated. 
This way ke caused by a programming error or by an attempt to load 
VNET inte an incompatikle virtual machine. The latter case can 
occur if the virtual rachine (1) has an incomplete instruction set, 
(2) has less than 512K of virtual storage, or (3) does not have the 
required VM/370 Diagnose interface support. The wait state code is 
loaded automatically during the initial loading and execution of 
the VNET supervisor, CMTINI, DMTREX, DMTAXS, and DMTLAX. 


Operator Action: Verify that the VNET virtual machine configuration 
has been correctly specified and that the "retrieve subsequent file 
description" functicn of CIAGNOSE code X'14' is supported. Dump 
the contents of virtual storage via the CP DUMP command. If the 
problem persists, notify your system support personnel. 


Explanation: An unrecoverable error has occurred during the reading 
of the VNET nucleus from CASD storage. This may be caused by a 
hardware malfunction of the DASD device. It may ke the result of 
(1) an incorrect virtual DASD device definition, (2) an attempt to 
use a System residence device unsupported by VNET, (3) incorrect 
VNET system generaticn procedures, or (4) the subsequent 
overwriting of the VNET nucleus on the system residence device. 
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012 
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The wait state code is loaded by DMTINI after an attempt, 
Successful or not, to issue the message: 


DMTINIGO2I IPL DEVICE REAL I/0 ERROR 


Operator Action: Verify that the VNET system residence device has 
been properly defined as a virtual DASD device and that the real 
DASD device is mounted and operable. If the preblem persists, dump 
virtual storage via the CP DUMP command and notify your system 
Suprfort personnel. The VNET system residence device may have to ke 
restarted or the VNET system may have to ke regenerated. 


Explanation: The VNET nucleus has been successfully written to the 
VNET system disk. This wait state code occurs at the end of VNET 
systen generaticn following the message: 

DMTINI410I NUCLEUS WRITE COMPLETE 


Operator Action: Test the newly loaded VNET system by IPLing from 
the VNET system disk that contains the new nucleus. 
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APPENDIX REMOTE TERMINALS AND STATIONS 


APPENDIX C AND 
N 


PART 1. NONPROGRAMMAELE REMOTE TERMINALS 


need 


This portion contains operational information for each of the following 
remote nonprogranmable terminals supported by the NPT line driver 
operating under VNET: 


IBM 2770 Lata Communication System 
IBM 2780 Data Transmission Terminal, Models 1 and 2 
IBM 3770 Data Communication System, nonprogrammable models 


IBM 3780 Data Communications Terminal 


The following topics are discussed as they relate to each terminal: 


Supported configuraticn 
Operational notes 
Entering commands 


Frror recovery procedures 


IEM 2770 AS A REMOTE TERMINAL 


aEeies «GEEReEEEE EEE GES EE 


SUPPORTED CONFIGURATION 


The ITEM 2770 Data Communication System with the 2772 Multipurpose 
Control Unit (from now cn called 2770) can be used as an NPT remote 
terminal. It can be connected to VNET via a switched or leased 
point-to-point communication line. 


The following devices are required for operating a 2770 as an NPT 
remote terminal: 


- 


One IBM 2213 Printer, Model 2, or one IBM 2203 Printer, or one IPM 
1053 Printer 


One IPM 2502 Card Reader, Model A1 or A2 


FECDIC Transmission Code 


Other supported equipment and features are as follows (feature numbers 
are shown in parentheses) ;: 


One IBM 545 Card Punch, Model 3 or 4, with or without 3950 
attachment. 


EECDIC Transparency (3650) 
Buffer Expansion (1490) 


Additional Buffer Expansion (1491) 
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e Space Compression/Expansion (6555) 


e Synchronous Clock (7705) 


2770 OPERATIONAL NOTES 


Establishing the connection with VNET is the same for all 
nenprogrammable terminals and is covered in "Part 3: VNET System 
Operation" under "Starting NPT" and "Signing on to NPT", 


During all 2770 terminal sessions with NPT, the 2770 console switches 
should ke set as follows: 


Switch Setting 
JOB SELECT VARIABLE SELECT SELECT 
INPUT KEYBOARD, 2 


(card reader) both up 

OUTPUT PRINTER, 2 

(card punch) bkoth up 

DIRECT DATA OUTPUT PRINTER up 

TERM MODE LINE 

SELECTION REQD down 

ANSWER MANUAL 

MCNITOR PRINT a¢ desired by 
installation, 


normally down 
Any of akove that refer 
to device not on your 2770 down 


All other VARIABLE SELECT 
Switches down 


During installation, your 2770 may have been provided with the 
equivalent of all the above switch settings at one of the five JOB 
positions on the JOB SELECT switch. If so, Simply set to that position 
and ignore all VARIABLE SELECT switches. When power is on, console 
lights show the settings that are in effect. 


The TRANSPCY switch should ke set in the down position except when used 
for transmitting ERBCDIC card decks that use all 256 possible punch 
combinations. 


ENTERING CCMMANDS 


The remote terminal operatcr submits commands to VNET through the remote 
card reader in the same manner as he enters card files. The commands 
are punched, one per card, starting in column 1. One or more commands 
may be sukmitted at any one time. Commands are only accepted before the 
ID card of an input card deck or after an input card deck has been 
completely processed (end-of-file generated). 


TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
command. The link is deactivated after the file currently being 
processed is completed. 
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ERROR RECOVERY PROCEDURES 


Most proklems you encounter result in lights appearing on the 2770 
console or the I/O devices themselves. Some lights are not error lights; 
these are DATA SET READY, CARRIER OFF, CATA IN BUFFER, LINE MODE, 
PROCFED, BIL, SFIN REQL, TRANSPCY, MANUAL ANSWER, and any of the I/0 
device lights that are not Elinking. Any I/O device light which is 
blinking indicates that the device is not ready. Other lights provide 
clues to problems and are discussed in the following sections. 


Error Recovery For A Line Crop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch will 
Stop. If the terminal was transmitting, the reader stops and VNET closes 
the partially transmitted file. 


In order to restart, you must redial the line and reenter your SIGNON 
card. When the SIGNON card is accepted ky VNET, normal line activity 
will resume. If receiving, activity will restart from the point of 
interruption. If transmitting, you can either restart from the file that 
was interrupted or you can send the rest of the data as a separate 

file. 


If seme other user dials in on the disconnected line before you do and 
Submits his own SIGNON card, VNET will recognize the new linkid as keing 
different from the one in effect at the time the line dropped. The new 
user is terminated and the link is deactivated. If your terminal was 
receiving, the printer or punch file is placed at the end of the queue 
fer your link and is put into HOLD status. 


To restart under these circumstances, you must first have the VNET 
operator reactivate your link via the START command. you can then redial 
the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity will resume. Transmission can be either 
continued or restarted. Printer or punch output will resume with the 
file following the one that was active at the time the line dropped. In 
order to process the interrurted file, you must change its status from 
HOLD to NOHOLD via the CHANGE command. 


Error Recovery When Transritting 


When transnitting, any card reader trouble is indicated by a blinking 
INPUT 2 or 3 light, whichever your card reader is attached to. The 
following lights on the card reader may further indicate the type of 
trouble: 


FEED CHECK 
The bottom card in the hopper failed to feed. Remove the cards 
fror the hcpper. Press the Non-Process Runout (NPRO) button. 
Repair the bottom hopper card, if necessary, and make sure the feed 
throat is clear. Reload the cards and push reader START and console 
START. 


ATTENTION 
Full stacker or empty hopper with EOF off. Correct the problem, 
then push reader START and console START. 
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REAL CHECK 

VALIDITY CHECK 
Last card in the stacker (if no jam) and the following card (run 
out by NPRO after hepper cards are removed) must be re-read. After 
appropriate correction, place these two cards at the front of the 
card stack in the hopper, push reader START and console START. 


TERMINAL ALCDRESS 
The NPT program is trying to send output while ycu are trying to 
start an input function. Continue the input procedure until you 
have turned on the RIC light. Then press CHECK RESET and wait for 
input to begin. Press CHECK RESET again if TERMINAL ADDRESS comes 
on again. 


EID RETRY 
The NPT program has failed to give permissicn to transmit. Press 
CHECK RESET to cause the 2770 to try again. If this fails, ask the 
local VNET operator to check the task. 


INPUT CHECK 

BUFFER CHECK 

TRNSPCY CHECK 
With any one of these Serious errors, you must always do a job 
restart. Make sure you have turned on the TRANSPCY switch if the 
input card deck contains object decks or other cards requiring 
transparent transmission. 


RECORD CHECK 

LINE CHECK 
These lights may come on while NPT is attempting retransmissions 
for line errors; they will go out if recovery is successful. If 
they stay on and the transmission does not proceed, you must do a 
CHECK RESET and restart the output device for the output to 
continue. 


Note: It is possible in this case to lose a record, or to have a 
record duplicated. 


Error Recovery When Receiving 


Output device trouble is indicated by blinking OUTPUT PRINTER or OUTPUT 
2 lights on the devices as follows: 


CARRIAGE CHECK 
The printer carriage, forms, or carriage tape are not ready or 
jammed. Correct the condition and press console CHECK RESET and 
START. 


PRINT CHECK 
The printer had a parity error. Press console CHFCK RESET and 
START. Failure to recover indicates hardware trouble. 
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CHECK light or any card punch not ready condition 
Hopper empty, stacker full, or jams are the possikle causes. Set 
the keyboard switch to KEYPCH. Remove any cards from the stacker 
or the eject station just below the stacker and discard all cards 
after the last one with a column 80 punch. Clear the entire card 
feed path. With blank cards in the hopper, press the FEED key twice 
and the RFLEASE key once and then set the switch to AUTO PCH. Press 
console CHFCK RESET and START. The first card through the feed 
after recovery is blank and should Le discarded. 


When receiving, certain console lights may require your attention as 
follows: 


TERMINAL ALDRESS 
The NPT program is trying to send output but your 2770 is not 
ready. Make sure your switch setup is correct, ready all output 
devices, and press console CHECK RESET. 


OVERRUN 
This usually indicates that features on your 2770 were not 
specified correctly when you signed on to the VNET virtual 
machine. Ask the VNET operator either to restart the task in order 
to send the correct SIGNON card or to change the recorded 
configuration. 


BUFFER CHECK 
This serious hardware error always requires you to reset and 
restart the operation. Failure to recover indicates hardware 
trouble. 


LINE CHECK 
The NPT program is attempting retransmissions. If they are 
successful, the light goes out. If the light stays on and printing 
or punching does not continue within a short time, you must do a 
line restart. 


For other combinations of error lights consult the publication System 
Components: IEM 2770 Data Communications System, GA27-3013. 


IEM 2780 AS A REMOTE TERMINAL 
SUPPORTED CONFIGURATION 


The IBM 2780 Data Transmission Terminal, Models 1 and 2, used as NPT 
remote terminals, can be connected to VNET via a switched or leased 
point-to-point line. FRCLIC Transmission, feature code 9762, is 
required. 


The following supported features are optional (feature numbers are in 
parentheses) ; 


e EEFCDIC Transparency (8030) 


e 120/144-Character Print Line (5820 or 5821) 
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e Multiple Record Transmission (5010) 


e Synchronous clock (7705) 


2780 OPERATIONAL NOTES 


Establishing the connection with VNET is the same for all 
nonprogrammable terminals and is covered in "Part 3: VNET System 
Operation" under "Starting NPT" and "Signing on to NPT", 


After having established the connection with VNET, the following steps 
must be performed: 


1. Make sure that the mode-selection knob is at one of the positions 
TSM-TRSP, TSM or REC. Do not put the knob in the PRINT or PUNCH 
position (to receive a punch file put the knob in REC position). 


2. Push START on the printer. 


ENTERING COMMANDS 


The remote terminal operator submits commands to VNET through the remote 
card reader in the same manner as he enters card files. The commands 
are punched, one per card, starting in cclumn 1. One or more commands 
may be submitted at any one time. Commands are only accepted before the 
ID card of an input card deck or after an input card deck has been 
completely processed (end-of-file generated). 


TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
ccmmand. The link is deactivated after the file currently being 
processed is completed. 


ERROR RECOVERY PROCEDURES 


Most proklems you encounter result in lights appearing on the 

reader-punch or printer control panels. Some lights are not error 

lights; these are DATA SET READY, the two READY lights, END OF FILE, I/0 

BFR FULL, CTR1, CTR2, CTR4 and usually LINE. 

POWER-ON reset 
The POWER-ON reset operation is referred to freguently throughout 
this manual. Contrary to its name, a POWER-ON reset does not 
involve the 2780 POWER ON/OFF switch (on the right side of the 
2780); this switch needs to be turned on only once during 2780 
operations. You can perform a POWER-ON reset by turning the mode 
selection switch knok from its current position to any other 
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position. This resets the 2780. If the knok is already where you 
want it, then turn it to some other position and back to the 
desired one. 


CAUTION: Do not do a FOWER-ON reset when the printer is printing, 
or while cards are keing read or punched. 


Frror Recovery For A Line Crop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch will 
stop. If the terminal was transmitting, the reader stops and VNFT closes 
the partially transmitted file. 


In order to restart, you must redial the line and reenter your SIGNON 
card. When the SIGNON card is accepted ky VNET, normal line activity 
will resume. If receiving, activity will restart from the point of 
interruption. If transmitting, you can either restart from the file that 
was interrupted or you car send the rest of the data as a separate 

file. 


If seme other user dials in on the disconnected line before you do and 
submits his own SIGNON card, VNET will recognize the new linkid as being 
different from the one in effect at tke time the line dropped. The new 
user is terminated and the link is deactivated. If your terminal was 
receiving, the printer or punch file is placed at the end of the queue 
fer your link and is put into HOLD status. 


To restart under these circumstances, you must first have the VNET 
operator reactivate your link via the START command. you can then redial 
the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity will resume. Transmission can be either 
continued or restarted. Printer or punch output will resume with the 
file following the one that was active at the time the line dropped. In 
order to process the interrupted file, you must change its status from 
HCLD to NOHOLD via the CHANGE command. 


Error Recovery When Transmitting 


TERM ADDR 
This light comes on when you are reading cards. If the cards stop 
reading and the REALY and TERM ADDR lights are on, perform the 
following steps: 


1. Remove the cards from the hopper and press NPRO to run out the 
two cards in the feed. 


2. Put these two cards in front of the deck previously removed in 
Step 1, and place the cards back in the hopper. 


a Do a POWER-ON reset. 


4, Wait for the TERM ADDR light to come on again. This may take 
aS long as 10 seconds. 


5. Ce another POWER-ON reset, press the END OF FILE and START, so 
that the END OF FILE and READY lights come on. 
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6. Cards should start reading within 15 seconds. If they do not, 
and the TERM ADCR light comes on again, repeat the above 
eteps. 


If the above steps continue to fail, you may have interrupted 
printing or punching to read in cards before the printing or 
punching had completed. Try to ready the printer and punch. 


DATA CHECK 

DATA CHECK and EQUIP CHECK 

DATA CHECK, EQUIP CHECK, and PARITY CHECK 
The reader could not read a card correctly. Perform the following 
steps; 


1. Remove cards fron the hopper (not the stacker). 


2s Fress NPRO. Two cards will run out into the stacker. The 
first of these cards is the bad one. 


3. Correct the bad card. 


4, Put ktoth cards kack in the hopper, followed by the cards you 
removed from the hopper. 


5s Press END OF FILE and START so that the END OF FILE and READY 
lights come on. 


OVER RUN 

PARITY CHECK 

PARITY CHECK and EQUIP CHECK 
RECORD and LINE 


To correct errors when these lights are on, you must first find out 


how many cards have keen read Eut not yet transmitted. Add up the 
CTR lights to do this. For example, if CTR1 and CTR2 are on, three 
cards have been read, rut net yet transmitted. Without removing 
all cards from the stacker: 


1. Remove the cards from the hopper. 


2.- Eress NPRO to run out the two cards in the feed mechanism. 


3. Remove the last Nt+2 cards from the stacker, where N is the 
number of cards read but not yet transmitted. 


4. Put these cards Eack into the hopper, followed by the cards 
you removed from the hopper in Step 1. Do a POWER-ON reset. 


5. Press END OF FILE and START so that END OF FILE and READY 
lights come on. 


EQUIP CHECK 
A mechanical error has occurred. Use the procedure for DATA CHECK, 
but you should not need to correct a card. 


LINE 
Wait a few moments to see whether or not the reader starts reading 
cards by itself. If it does not: 


ak Press STOP. 
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2. Press END OF FILE and START So that the END OF FILE and REALTY 
lights come on. 


HOPE 
No card was fed. Check the Lottom card in the hopper for damaged 
edges. Repair or remake the card and replace it and the rest of the 
cards kack in the hcpper. Press END OF FILE and START so that the 
END OF FILE and REALCY lights come on. 


Error Recovery When Receiving 


Sceme of the errors you may encounter when receiving are 
self-explanatory, such as END OF FORM (another box of paper is needed) 
or FORM CHECK (the paper is jammed). 

One error deserves particular attention. It is indicated by OVER RUN 
and INCP. If you get this error, you may have specified the wrong 
remote configuraticn on the SIGNON card and NPT is attempting to use 
features your 2780 Data Transmission Terminal does not have. Ask the 
VNET operator either to restart the task, in order to send the correct 
SIGNON card, or to change the recorded configuraticn in the VNET link 
takle via the CEFINE command. 


You may also see the following error indicators: 
TERM ADDR 
The device (printer or punch) is not ready. 
1. Press STOP and CHECK RESET on the reader-punch. 
2. Make the output device ready. 
EQUIP CHECK 
The punch has mechanically malfunctioned. Press NPRO to run out 


the cards in the feed mechanism and discard them. Make the punch 
ready again. 


SYNCH CHECK 
The printer has printed a line containing errors. 
1. Press STOP. 
2.- Press RESET (on printer). 
3. Press the START Eutton on the printer; the line is reprinted. 
PARITY CHECK 
If the printer was printing, do a POWER-ON reset and press START on 
the printer. (You may get some duplicate print lines.) 
If the punch was punching: 
1. Remove cards from the hopper (not the stacker) 


2s Press NPRO to run out the two cards in the feed mechanism 
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3. Throw away the last N+K cards that were stacked 
where: 
N is the number represented by the CTR lights. For example, 


if CTR1 and CTR2 are lit, N is 3; if all CTR lights are 
off, N is 0. 


RK 
it 


2 if all CTR lights are off or if the I/O BFR FULL light 
is off. 


1 if any of the CTR lights and the I/O BFR FULL light are 
on. 


4. Reload blank cards in the hopper and make the punch ready 


For other combinations of error lights, consult the publication IBM 2780 
Data Transmission Terminal -- Component Description, Order No. 
GA27-3005. 


IPM 3770 AS A REMOTE TERMINAL 


SUPPORTELC CONFIGURATION 


The IBM 3770 Data Communication System can ke used as an NPT remote 
station only when operating in 2770 or 3780 BSC mode. It can be 
connected to VNET via a switched or leased point-to-point communication 
line. The IBM 3770 is only supported on a communication line 
terminating in an Integrated Communications Adapter (ICA) on the 
System/370 Model 135, an IEM 2701, or an IEM 3704/3705 Communications 
Centroller. The 3770 keykoard is not supported. 


The following devices are required for operating the 3770 as an NPT 
remote station: 


e One of the following communication terminals: 


IBM 3771 Models 1, 2, and 3 (in 2770 mode) 

IBM 3773 Models 1, 2, and 3 (in 2770 mode) 

IBM 3774 Models 1 and 2 (in 2770 mode) 

IBM 3775 Model 1 (in 2770 mode) 

IBM 3776 Models 1 and 2 (in 2770 or 3780 mode) 
IBM 3777 Model 1 (in 2770 or 3780 mode) 


e One IEM 2502 Card Reader, Model Al, A2, or A3;3; IBM 3501 Card Reader 
or IBM 3521 Card Punch with the read feature installed 


The valid terminal/reader combinations are shown on the following table. 
Note: the applicable attachrent features rust also be ordered. 


Communication Reader 
Terminal Supported 
IBM 3771 99015: 3921 
IBM 3773 NONE 

IBM 3774 NONE 

IBM 3775 NONE 

IEM 3776 3501, 3521 
IBM 3777 2502 


190 VNET Reference and Oferations 


The 3773, 3774 and 3775 communication terminals are supported only for 
ccnsole printer output and for input (in card image format) from the 
diskette. For further information on these terminals, refer to the 
following puklications: 

IEM 3773, 3774, and 3775 Progranmable Cormunication Terminals: 
Programmer's Guide, Order No. GC30-3028 

Orerator's Guide, Order No. GA27-3114 


The following features/functions are included with 2770/3780 BSC 
compatibility: 


e ERBCDIC transmission code 

e FEFECDIC transparency 

e 256/256 kyte alternating Ltuffers (2770 mode) 
e 512/512 kyte alternating kuffers (3780 mode) 
e Extended retry 

e External clock (up to 4800 EPS) 

e WACK response 

e Printer form controls 

e Device selection 

e Expanded print line (132 fositions) 


e Transmit/receive monitor print (2770 prints only after positive 
acknowledgement from the line. The 3770 always prints) 


Other supported equipment and functions are as follows: 

e One IBM 3521 Card Punch (not supported on 3773 or 3777) 
e One ITEM 3784 Line Printer (standalone, with 3774 only) 
e Space compression/expansion 

e Diskette storage 


If installed, the diskette can give expanded inrfut/output capability 
with 2770/3780 BSC operations. 


When the 3770, is in 277073780 BSC mode, it hasS two operator-selected 
modes for remote component selection: 


1. Data to Selected Device with Default to Printer: In this mode of 
operation, the data from the line is directed to the output device 
specified by the component selection (DC) character received. 
Component selection characters used are as follows: 


DC1--Selects Ccnsole Printer 
CC2--Selects Card Punch 
CC3--Selects Disk 
Dc4u--Selects Line Printer 


If no component selection (LCC) character is received, an automatic 
default occurs to outfut the data to the printer. 
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2. Data to Magnetic Disk with Transparent Data to Punch: In this mode 
of operation, the data from the line is directed to the magnetic 
disk unless it is transparent data. If transparent data is 
received, it is directed to the punch. If component selection (DC) 
characters are received, they are stripped off and ignored. 


3770 OPERATIONAL NOTES 


Establishing the connection with VNET is the same for all 
ncnprogrammable terminals and is discussed in “Part 3: VNET System 
Operation" under "Starting NPT" and "Signing on to NPT", 

Operation of the 3770 system is discussed in the following publications: 


Cperating Procedures Guide: 


IPM 3771 and 3773 Communications Terminals 
Order No. GA27-3100 


IBM 3774 and 3775 Communications Terminals 
Order No. GA27-3094 


Hi 
td 


M 3776 Communication Terminal, 
r 


rder No. GA27-3107 


i) 
er) 


IBM 3777 Communication Terminal, 
Order No. GA27-3124 


ENTERING CCMMANDS 


The remote terminal operator submits commands to VNET through the remote 
card reader in the same manner as he enters card files. The commands 
are punched, one per card, starting in cclumn 1. One or more commands 
may be sukmitted at any one time. Ccmmands are only accepted before the 
ID card of an input card deck or after an input card deck has been 
completely processed (end-of-file generated). 


TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
command. The link is deactivated after the file currently being 
processed is completed. 


FRROR RECOVERY 


The OPRN CHECK (Operational Check) indicator turns on when an operating 
procedure error occurs, or an input or output device needs some operator 
attention (such as a printer out-of-forms condition). An error code 
displays in the numeric position readout (NPR) indicators. 


The SYSTEM CHECK indicator tvtrns on when a controller, or an input or 


output device error occurs. An error code displays in the numeric 
Fesition readout (NPR) indicators. 
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The operator panel speaker sounds when an operational check or a system 
check occurs; if installed, the audible alarm sounds for jobs other than 
keyboard jobs when the EXTEND/ALARM switch is on. 


When the 3770 stops due to an error or an attention condition: 


e Either the SYSTFM CHECK or the OPRN CHFCK indicator is on. 


e If an input or output device error occurred, the operator panel 
indicator for the device in error turns on. 


e The number displayed in the readout (NPR) indicates the error type. 


If the audible alarm sounds, press the RESET key to turn it off. For 
the error recovery procedure that applies to the error code number 
displayed, see the section "Numeric Pcsition Readout (NPR) Error Codes" 
in the Operating Procedures Guides for 3770 terminals. 


Error Recovery For A Line Crop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch will 
stop. If the terminal was transmitting, the reader stops and VNET closes 
the partially transmitted file. 


In order to restart, you must redial the line and reenter your SIGNON 
card. When the SIGNON card is accepted ky VNET, normal line activity 
will resume. If receiving, activity will restart from the point of 
interruption. If transmitting, you can either restart from the file that 
was interrupted or you can send the rest of the data as a separate 

file. 


If scme other user dials in on the disconnected line before you do and 
submits his own SIGNON card, VNET will recognize the new linkid ‘as being 
different from the one in effect at the time the line dropped. The new 
user is terminated and the link is deactivated. If your terminal was 
receiving, the frinter or punch file is placed at the end of the queue 
fer your link and is put into HOLD status. 


To restart under these circumstances, you must first have the VNET 
operator reactivate your link via the START command. you can then redial 
the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity will resume. Transmission can be either 
continued or restarted. Printer or punch output will resume with the 
file following the one that was active at the time the line dropped. [In 
order to process the interrurted file, you must change its status from 
HOLD to NOHOLD via the CHANGE command. 


IPM 3780 AS A REMOTE TERMINAL 


SUPPORTED CONFIGURATION 


The IBM 3780 Data Communications Terminal, used as an NPT remote 
Station, can be connected to VNET via a switched or leased 
point-to-point communications line. EBCDIC transmission code is 
required. 
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The following devices and features are optional (feature numbers are in 
parentheses) : 


e One IEM 3781 Card Punch S 
e Component Selection (1601, required for the 3781) 

e EPCDIC Transparency (3601) 

e Additional Print Positions (5701) 


e Synchronous Clock (7705) 


3780 OPERATIONAL NOTES 


Establishing the connection with VNET is the same for all 
nonprogrammable terminals and is covered in "Part 3: VNET System 
Operation" under "Starting NPT" and "Signing on to NPT", 


For 3780 operations with NPT, set certain 3780 console switches as ‘a 
fcllows: 
Switch Setting 
TERM MODE LINE/HOME LINE 
TRNSPCY ON or OFF as 
desired 
SPACE COMPRESS/EXPAND ON or OFF as 
desired 
OFF LINE TEST OFF 
AUTO RESTART ON 
INQUIRY MODE OFF S) 
ANSWER AUTO/MAN OFF 


TELE (WORLD TRADE ONLY) OFF 

SPEED (WORLD TRADF ONLY) At the desired 
transmission 
speed 


ENTERING COMMANDS 


The remote terminal operator submits commands to VNET through the remote 
card reader in the same manner as he enters card files. The commands 
are punched, one per card, starting in column 1. One or more commands 
may be submitted at any one time. Commands are only accepted before the 


ID card of an input card deck or after an input card deck has been 
completely processed (end-of-file generated). 
Interrupting Output Processing ® 


If it becomes necessary to enter a command or input card file while the 
terminal is busy with a lengthy output processing, the output may be 
interrupted as follows: 

1. Ready the card reader with the input cards (commands and/or data). 


2.- Press TERM RESET 


3. Press START on the console. 
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Note: Due to the nature of the 3780 hardware, print or punch records 
that were in the 3780 kuffer when TERM RESET was pressed will be lost ky 
this procedure. The alternative is to wait until the output processing 
has completed. 


TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
ccmmand. The link is deactivated after the file currently being 
processed is completed. 


ERROR RECOVERY PROCEDURES 


Most proktlems you encounter result in lights appearing on the 3780 
console and on the I/O devices themselves. Some lights are not error 
lights; these are DATA SET READY, CARRIER OFF, DATA IN BUFFER, LINE 
MODE, BIC, TRANSPCY, MANUAI ANSWER, and any of the I/O device lights 
when on steady. Any I/0 device light that is blinking indicates that 
the device is not ready. Other lights provide clues to problems and are 
discussed in the following sections. 


Error Recovery For A Line Crop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch will 
stop. If the terminal was transmitting, the reader stops and VNET closes 
the partially transmitted file. 


In order to restart, you must redial the line and reenter your SIGNON 
card. When the SIGNON card is accepted by VNET, normal line activity 
will resume. If receiving, activity will restart from the point of 
interruption. If transmitting, you can either restart from the file that 
was interrupted or you can send the rest of the data as a separate 

file. 


If scme other user dials ir on the disconnected line before you do and 
Submits his own SIGNON card, VNET will recognize the new linkid as being 
different from the one in effect at the time the line dropped. The new 
user is terminated and the link is deactivated. If your terminal was 
receiving, the printer or punch file is placed at the end of the queue 
for your link and is put into HOLD status. 


To restart under these circumstances, you must first have the VNET 
operator reactivate your link via the START command. you can then redial 
the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity will resume. Transmission can be either 
continued or restarted. Printer or punch output will resume with the 
file following the one that was active at the time the line dropped. In 
order to process the interrupted file, you must change its status from 
HOLD to NOHOLD via the CHANGE command. 
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When transmitting, any card reader trcuble is indicated by a blinking J 
reader light. The following lights on the card reader may further 
indicate the type of troukle: 


FEED CHECK 
The bottom card in tke hopper failed to feed. Remove hopper 
cards. Press NPRO. Repair the ktottom hopper card, if necessary, 
and make sure the feed throat is clear. Reload the cards. Press 
reader START and console START. 


ATTENTION 
Full stacker or empty hopper with EOF OFF. Correct the problem, 
press reader START and console START. 


REAL CHECK 

VALIDITY CHECK 
Last card in stacker (if no jam) and following card (run out by 
NPRO after hopper cards are removed) must be re-read. After 


appropriate correction, place these two cards at the front of the Z 
unprocessed cards in the hopper, push reader START and console 
START. 


TERMINAL ACDRESS 
The NPT program is trying to send output while you are trying to 
Start an input function. Continue input procedure until you have 
turned on the BID light. Then press CHECK RESET and wait for input 
to begin. Press CHECK RESET if TERMINAL ADDRESS comes on again. 


INPUT CHECK ’ 
EUFFER CHECK J 
IRNSPCY CHECK 

With these serious errors you must always do a job restart. Make 

Sure that you have turned on the TRANSPCY switch if the input card 

deck contains object decks or other cards requiring transparent 

transmission. 


RECORD CHECK 
LINE CHECK 
These lights may come on while NET is attempting retransmissions 
for line errors; they will go out if recovery is successful. If 
they stay on and the transmission does not froceed, you must doa 
CHECK RESET and restart the input device. The input is continued; 
however, it is possible in this case to have a record duplicated. 


Error Recovery When Receiving 


Output device trouble is indicated by a Llinking printer light on the 
console panel or EQUIP CHECK on the 3781 Card Punch panel. 


FORM CHECK 

CARRIAGE INTERLOCK 

END-OF-FORM 
The printer carriage, forms, or carriage tape are not ready or 
jammed. Correct the condition; press CHECK RESET and START on the 
console panel. 
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PRUFFER CHK 
The printer had a parity error. Press CHECK RESET and START on the 
console panel. Failure to recover indicates hardware trouble. 


EQUIP CHECK 
The punch has mechanically malfunctioned. 


Make the punch ready again. 


When receiving, certain other console lights may require your attention, 
as follows: 


TERMINAL ALCDRESS 
The NPT program is trying to send output but your 3780 is not 
ready. Make sure your switch setup is correct, ready all output 
devices, and press console CHECK RESET. 


EUFFER CHECK 
This sericus hardware error always requires you to reset and 
restart the operatior. Failure to recover indicates hardware 
trouble. 


LINE CHECK 
The NPT program is attempting retransmissions. If NPT is 
successful, the light goes out. If the light stays on and printing 
or punching does not continue within a short time, you must do a 
line restart. 


For other combinations of error lights, consult the publication 
Component Information for the IBM 3780 Data Communication Terminal, 
GA27-3063. 


Appendix Cs Remote Terminals and Stations 197 


198 VNET Reference and Orerations 


APPENDIX C. REMOTE TERMINAL AND STATIONS 
PART 2. PROGRAMMARLE (SEOOL MULTI-LEAVING) REMOTE STATIONS 


This porticn contains operational information for each of the following 
remote progammable MULTI-LEAVING stations supported by the SML line 
driver operating in HOST mode under VNET: 


IPM System/360 

IBM System/370 

IEM System 360 Model 20 

IBM 2922 Programmakle Terminal 
IBM System/3 Model 10 Card System 
IBM 1130 System 


The following topics are described as they relate to each station: 


Supported configuration 

Remote Station Processor program functions 
Operating procedures 

Error Recovery Procedures 


Another section provides infcrmation on the use of the VNET virtual 
machine as a Remote Jok Entry workstation communicating with a 
HASP/ASP-type katch processor. 


In addition, MULTI-LEAVING Remote Jok Entry Work Station (MRJE/WS) 
Support is kriefly descriked for the following remote stations: 
IBM System/3 Models 6, 8, 10, 12, and 15 
IEM System/32 


The MRJE/WS support for these systems is described in publications 
listed in the section "IPM System/3 and System/32 as Remote Stations". 


IBM SYSTEN/360 AND SYSTEM/370 


S REMOTE STATIONS 


The following sections contain instructions for operating any model of 
System/360 or System/370 equipped for EBCDIC transmission and binary 
synchronous communications, as a HASP MULTI-LEAVING remote station. The 
term System/360 is used to refer to btoth the System/360 and the 
System/370. 


CONFIGURATION SPECIFICATICNS 


Any System/360 with 8K or more bytes cf main storage, a supported 
transmission control unit, and a supported card reader may be used as an 
VNET remote station. 

The following transmissicn ccntrol units are supported: 

e Integrated Communications Adapter (ICA) on the System/370 Model 135. 


e IPM 2701 Data Adapter Unit with Synchronous Data Adapter Type II. 
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e IEM 2703 Transmission Control Unit with Synchronous Terminal 
Centrol. 


e IBM 3704 Communications Ccntroller in emulaticn mode only. 

e IBM 3705 Communications Centroller in emulaticn mode only. 

The following unit record devices are supported: 

e FEM 2540 Card Read Punch 

e IBM 2501 Card Reader 

e IBM 2520 Card Read Punch 

e IPM 1442 Card Read Punch 

e IBM 1403 Printer 

e IBM 1443 Printer 

e IBM 3203 Printer Model 4 

e IBM 3211 Printer 

e IBM 3203 Printer Model 4 (for System/370 Models 138 and 148 only) 
e IBM 1052 Printer-Keyboard 

Communications lines (switched or nonswitched) whose speed is compatible 


with the hardware are supported. Only one console, the standard operator 
ccnsole, is supported on each remote station. 


REMOTE TERMINAL PROCESSOR (RTP) PROGRAM 


A special program for the IBM System/360 allows it to operate as a 
remote workstation for MULTI-LEAVING operating systems such as HASP and 
ASP. For details on generating the appropriate workstation program, see 
the publication OS/VS2 HASP II Version 4 System Programmer's Guide, 
Order No. GC27-6992. An IEM System/360 under control of this program 
and communicating with VNET can Le viewed as a logical extension of the 
VM/370 spool system. This program (HASP/RTP360) performs input, output 
and communication functions. 


HASP/RTP360 can read, print, and punch data concurrently, depending on 
the options selected by the installation and the capabilities of the 
unit reccrd devices. 


Due to the use of blocking and character compression to minimize line 
transmission time, the speed at which the System/360 unit record devices 
ofrerate is dependent on the data being transmitted and the number of 
concurrent functions. Certain job mixes, because of their data 
characteristics, enable HASP/RTP360 to operate the unit record devices 
at near maximum speed. Other jok mixes may cause the devices to operate 
in short kursts because of contention on the communications line. 
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Input Functions 

HASP/RTP360 provides the following input functions at the remote 
station: 

e Reads from the attached card reader(s). 

e Recognizes operator requests, and reads from the attached console. 


e Identifies, compresses, and blocks card images and commands for 
transmission to VNET. 


e Queues Llocked records for transmission to VNET. 


Output Functions 

HASP/RTP360 provides the following output functions at the remote 
station: 

e Dequeues blocked records received from VNET. 

e Identifies the device required for output of the records. 


e Deblocks and decompresses outfut records, queueing the images for 
printing, punching, or typing. 


e Prints, punches, and tyres the outfut records, as required. 


e Sets status flags, indicating backlog conditicns on the output 
devices. 


Communication Functions 
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HASP/RTP360 provides the following communication functions at the remote 
station: 


e Establishes and maintains synchronization with VNET. 


¢ Dequeves blocked input requests and transmits them to VNET (upon 
request from VNET). 


e Provides backlog status flags, indicating the station's ability to 
‘ receive the various outfut streams from VNET. 


e Receives output from VNET and queues the blocked records for 
processing. 


OPERATING FROCEDURES 


The following sections provide information for initiating and operating 
the HASP/RTP360 program during the remote job stream processing 
session. 
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The initiation of a remote job stream processing session involves 
initial program loading of the HASP/RTP360 program deck, establishment 
of the communication lines, and exchange of initial control information 
between VNET and the HASE/RTP360 program. The initial control sequence 
ends with the passing of the sign-on information from the remote 
station. 


Initial Program Load (IPL) 


The following steps should be taken to perform the initial program 
loading of the HASP/RTP360 program deck: 

1. If the power for the System/360 is off, press POWER ON. 

2. Ready the HASP/RTP360 deck in reader 1 (designated by central 
system personnel) and press START and EOF on the reader. (The last 
card of the deck skould ke klank or a /*SIGNON card, as directed by 
the installation.) 


3. Ready printers, punches, and the console. 


4. Set the LOAD UNIT rotary switches to the device address of reader 
1. 


5. Disable the interval timer, if present. 

6. Set the MODE (RATE) and DIAGNOSTIC (FLT) switches to PROCESS. 

7. #$j%Set CHECK CONTROL to STOP. 

8. Press SYSTEM RESET and LOAD. 

9. All cards of the HASP/RTP360 deck are read by the reader. 

10. HASE/RTP360 prints the /*SIGNON card, if present, followed by a 
VNET environment recording error printout (if the contents of core 


remain unchanged since the last run of the program). 


11. The remote station if now ready to communicate with VNET. 
HASP/RTP360 waits while communications are established with VNET. 


Establishing a Communication Line 


The procedures for establishing communications with VNET are as follows: 


1. Ready the data set. This involves different actions, based on the 
type of data set. Readying nonswitched lines only requires that 
the data set DATA button ke pressed (if present). To ready a dial 
line data set, perform the following: 


ae Press the TALK Eutton, and lift the receiver off the data set. 
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b. Dial the assigned numker for the remote station. 


c. If the VNET line is available, the central system answers with 
a high pitched tone. Press CATA and hang up immediately; the 
data set is now ready. 


ad. If the VNET line is in use, a busy signal is received. Hang up 
and try again later, or dial an alternate ccmmunication line 
number. 


e. If the call is not answered, the VNET operator has not given 
the necessary ccmmand to authorize use of that communication 
line. Contact the VNET operator and request that he issue the 
START command for your link. 


2. When requested by VNET, HASP/RTP360 begins the initial control 
sequence. 


3. When the initial sequence is complete, the sign-on information is 
transritted to VNET. HASP/RTP360 "handshakes" with VNET until the 
processing of job streams actually kegins. 


Qutput Processing 


The printing and punching cf remote output is handled automatically by 
the VNET - HASP/RTP360 system, except as controlled ky the remote 
station cperator or VNET operator, via commands to VNET. 


Input Processing 


With the exception of 2520 ard 1442 combination reader/punch devices, 
input sukmission can be initiated at any time from any card reader 
supported by the HASP/RTP360 program. Multiple readers may be used 
concurrently. Place the cards in the input hopper, and press reader 
START. When all of a input stream has been loaded into the hopper, press 
reader EOF to allow the reading of the last cards to signal the program 
that the end of stream has keen read. 


HASP/RTP360 input readers are considered always "hot"; that is, the 
program is continually testing each reader and attempting to read 


cards. When any card reader is loaded, HASP/RTP360 immediately reads 
and transmits the cards to VNET. 


Operating a Combination Card Read Punch 


Devices with single card paths for both read and punch functions are 
termed combination reader/punches if they are supported for both 
functions. The following are supported combination devices: 

e 1442 Card Read Punch 

e 2520 Card Read Punch 


Dual devices have four basic status conditions that affect the operator: 


1. Neutral -- reader empty during normal program execution. 
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2e Input -- reading normal input stream. 
3. Output -- punching rormal output from VNET. 


4. Output error recovery -- attempting to recover from punch errors. 


At IPL time, the combination device is in neutral status and may be 
treated as any reader device, since the operator is at liberty to submit 
multiple input streams at any time. Any E-lank cards mixed in the input 
stream are submitted to VNET as input. When HASP/RTP360 recognizes the 
end-of-file (EOF) the combination device reverts to the neutral status. 


When the combination device is in neutral status, the operator may 
choose to ready the device with L-lank cards, placing the device in 
output status. If VNET has output waiting, HASP/RTP360 responds 
immediately by punching the EbElank cards. However, after all punching is 
finished, or if there is a pause due to low line speeds, the operator 
may not run the remaining cards out of the device and ready it with job 
stream cards. The procedure fcr interrupting the output mode follows: 


1. Press STOP on the device. 


2e Remove the cards from the hopper. (Do not run the cards out of the 
, card path.) 


3. Place the input streamr cards in the hopper, and press reader 
START. 


4. If the punch is busy, the device continues punching until the input 
strear is encountered; then, the device enters input status. (It is 
not necessary that all Elank cards ke removed from the hopper.) 


5. If the punch is momentarily idle, the operator can cause the device 
to pass one card through ky pressing reader STOP and then START. If 
several blank cards are in the hopper in front cf the job stream, 
the operation must ke repeated for each blank card. 


The combination device is in error recovery status when a punch error 
occurs. HASP/RTP360 attempts to repunch the record in error into the 
following card. If HASP/RTP360 encounters a punched card, a read error 
occurs (see unit record error procedures). The operator should run out 
the input stream cards using the NPRO key, place one or more blank cards 
in front of the input stream, and ready the device. 


ENTERING COMMANDS 


All messages entered into the 1052 operator's console via the keykoard 
are transmitted to VNET for action. Although all commands transmitted to 
VNET are listed on the VNET operator's console, only those available to 
the remote user are read and acted upon. 


The operator should perforn the following steps when entering commands: 
1. Press the REQUEST button on the right side of the keyboard. The 
ATTN indicator (indicator akove the keyboard on the 1052) glows 


momentarily. 


2. When the PROCD indicator comes on, type in the command and press 
EOB (numerical 5 key rressed while ALTN CODING key is depressed). 
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3. If a typing error is noticed prior to pressing FOB, press CANCEL 
(numerical 0 key pressed while ALTN CODING is depressed) and repeat 
step 2. 


4, If, after receiving a PROCD indicator, no command is to be entered, 
press FOB. 


TERMINATING A SESSION 


To terminate remote processing, the remote station operator should enter 
a DRAIN command or a /*SIGNOFF card which prevents VNET from initiating 
any more remote output and releases the communication line (if switched) 
when the current print and punch streams are finished. The DATA light on 
the data set goes out and RBSCA enters a check condition. For nonswitched 
lines, VNET makes the line available and waits for an initial sequence 
request from the HASP/RTP360 program. HASP/RTP360 logs UNIT CHECK on the 
ccnsole message device. The operator should determine whether printing 
and punching of output streams have successfully terminated and should 
press STOP on the CPU. To start a new session, the operator must perform 
the steps described previously, starting with the Initial Program Load 
of HASP/RTP360. 


ERROR RECOVERY 


The following sections indicate some common error conditions and the 
necessary steps for recovery from the errors. 


Communication Adapter Frrors 


Due to the design of the synchronization technique for VNET remote 
stations, no errors are expected during a processing session. The 
unusual occurrence, therefore, of any error condition results from 
either system or communication facility malfunction or from operational 
conditions. In general, the display of error messages is only 
informational, kecause the station processor automatically initiates the 
appropriate recovery action. A statistical summary of all errors is 
maintained in the VNET Environmental Recording Table, and a historical 
report is produced each tine HASP/RTP360 is loaded, unless storage has 
been cleared. Additionally, the occurrence of any error causes a 
descriptive message to be displayed immediately on the console 
typewriter. Figure 8 indicates each possible comrunication error, its 
meaning, and the recovery action taken. 


Unit Record Errors 


Many of the unit record device errors that can occur during processing 
allow HASP/RTP360 to continue processing without operator intervention. 
Some errors (such as DATA check, END OF FORM, etc.) require operator 
assistance before use of the device can be continued. In any event all 
errors occurring on unit record devices are logged in the VNET 
Environmental Recording Frror Printout Table and are displayed 
immediately on the 1052 operator's console. 
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When the error message is printed, the operator should perform the 


fcllowing: 


1. Determine which device is in error (see Figure 9). 


2. Note the device status; if HASP/RTP360 continues to use the device,. 
the error message is informative in nature. 


3. Correct the error in accordance with procedures prescribed for the 
device. 


4. Ready the device to resume operation. 


O1rree00 


ine) | 


02000000 | 


| 


0 


ee) 


rrrr00 | 
| 
| 
| 
| 
04c00000 | 
| 
| 


05ss0000 | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


06cc0000 | 
| 
| 
| 


07000000 | 


= sc a ee a ee eee es ee ee ee ee ee ee i | 


Figure 8. 
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was duplicated cr lost. | block is ignored. If a lost| 
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ee expected kleck number restart the job. 
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Negative reply received. A transmission block] The Ead record is 
was not correctly received ky VNET. | retransmitted. 
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Unknown response received. An unrecognizable 
control character was received from VNET. 


| VNET is requested to 

| 
rrrr = first two characters received (if rrrr| 

| 

| 


retransmit the record. 


is correct sequence, ending sequence 
was kad). 


Unit exception. Indicates receipt of an EOT | VNET is requested to 
character from VNET (EOT is not utilized in | retransmit the record. 
MULTI-LEAVING). | 


Unit check. A check condition has occurred in| The failing cperation will 
the communication adapter. be retried. If a write 

ss = sense Lyte indicating type of check: operation waS in process at 
the time cf error, the write 


| 
| 
| 
80 = Command reject | will be reissued; otherwise, 
40 = Intervention required | VNET is reguested to 
20 = Bus out check {| retransmit. 
10 = Equipment check | 
08 = Data check { 
04 = Overrun | 
02 = Lost Data | 
01 = Time out | 
Unusual end. An unusual end condition has | The failing operation is | 
occurred in the channel or control unit | wetrieds. 
interface. | | 
cc = CSW kyte 5 { | 
J. ae 
SIO failure. A start I/O instruction was | The Start Iv0O is retried. | 
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rejected by the Synchronous Data Adapter. { 
ee Sa | 
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HASP/RTP360 Communication Adapter Error Messages 


Remote Station Restart 


In the event of an untimely interruption of the remote station operation 
(such as a machine, program, ccmmunications, or environmental 
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failure), the remote staticn crferator should notify appropriate 
maintenance personnel of the malfunction and save material that can be 
used to determine the source of the failure. With the aid of the VNET 
operator, the remote operator should also prepare to restart the station 
as follows: 


1. Notify the central operator of the failure and, if necessary, 
request his assistance in preparing for restart. 


2. Determine, from the VNET operator's record, which deck was 
currently being transmitted to VNET. The input stream, starting 
with that current deck, must be submitted to VNET after restart. 


3. Determine the loss of data on the output devices and inform the 
VNET operator to bkackspace or restart the printer or punch, as 
necessary. (The VNET link should ke made available for a 
subsequent session with the remote station or other stations within 
the system.) 


4. When the remote station is available, restart the session beginning 
with the Initial Prcgram Load of HASP/RTP360. 


ees ee EE CS ee ES 


| 


Message | Description Program Action 


ee ee ee re 


ee  — —————————e 


Unit check. Dévice with address "aaa" has 
unit check error descriked Ly sense byte "ss" 
and/or indicator lights on the device 
console. 


O5ss0aaa 


Sample sense Eyte settings: 


40 = Intervention required Wait for orerator. 

10 = Equipment check Treat as data check. 

08 = Data check — card read, card 
punched, or line printed ignore, retry, or wait for 
incorrectly. operator. 

01 = Carriage contrel tape channel 9 Ignore. 


encountered on printer 


06cc0aaa Unusual end. Previous I/O came to an unusual | 
end. IBM customer engineer should he { 
consulted. | 
eG CSW kyte 5 { 
aaa device address { 


SS a I A SS AS SS A SSS AMES BE 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Depending on device: | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Note: Printing on a line that has a carriage centrol tape channel 9 or 12 punch | 
appears as an é€rror and is logged aS an error. The installation should place these | 
punches in line positions that do nct contain print information. Do not eliminate | 

| 


the punches from the carriage tape. 


Figure 9. HASP/RTP360 Unit Record Error Messages 


IBM SYSTEM/360 MODEL 20 ANC ITEM 2922 AS REMOTE STATIONS 


——_ eee SSE 


The following section contains instructions for operating the IBM 
System/360 Model 20, equipped with a Binary Synchronous Communications 
Adapter, or the IBM 2922 Programmable Terminal aS a VNET MULTI-LEAVING, 
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remote station. All information on the Model 20 also applies to the IBM 
2922 unless a variation is noted. 


Configuration Specifications 


Any submodel of the Model 20 with at least 8K bytes of main storage, a 
Binary Synchronous Communications Adapter, EFECDIC transmission, Full 
Transparency, and a supported card reader may be used asS a VNET remote 
station. 


The following unit record devices are supported in any combination: 
e IBM 2501 Card Reader 

e TEM 2520 Card Read Punch 

e IBM 2560 Multi-Function Card Machine 

e IBM 1442 Card Punch 

e IBM 1403 Printer 

e IBM 2203 Printer 

e IEM 2152 Printer-Keyboard 


Any speed communication line supported by the hardware (switched or 
nonswitched) is supported. It is recommended (but not required) that a 
submodel 5 be used in conjunction with high-speed communications lines 
(19,200 kps and greater) for maximum performance. Certain other 
features of the Model 20 that are supported but are not required 
include: 


e 2152 Printer-Keyboard. Cannot be used on other than a submodel 5 if 
a high-speed communications line (19,200 bps or greater) is used. 


The IBM 2922 is supported as a VNET remote station with the same package 
as is used with the Model 20. The standard 2501 Card Reader and 1403 
Printer availakle with the 2922 are the supported input and output 
devices. 


Remote Terminal Processor (RTP) Program 


A special program exists for the IBM System/360 Model 20 and the IBM 
2922 Programmable Terminal which allows them to operate as remote 
workstations for MULTI-LEAVING operating systems such as HASP and ASP. 
For details on generating the appropriate workstation program, see the 
GC27-6992. A Model 20 or IBM 2922 under control of this program and 
ccemmunicating with VNET can be viewed as a logical extension of the 
VM/370 spool system. This program (HASP/RTPM20) performs input, output 
and communications functions. 


HASP/RTPM20 can read, print, and punch data concurrently, depending on 


the options selected by the installation and the capabilities of the 
unit record devices. 
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Due to the use of blocking and character compression to minimize line 
transmissicn time, the speed at which the Model 20 unit record devices 
operate is dependent on the data being transmitted and the number of 
concurrent functions. Certain job wixes, because of their data 
characteristics, enable HASP/RTPM20 to operate the unit record devices 
at near full speed. Other ‘job mixes may cause the devices to operate in 
short bursts because of ccntéention on the communications line. 


Input Functions 


HASP/RTPM20 provides the following input functions at the remote 
station: 

e Reads from the attached card reader(s). 

e Recognizes operator requests, and reads from the attached console. 


e Identifies, compresses, and blocks card images and commands for 
transmission to VNET. 


e Queues Llocked records for transmission to VNET. 


Output Functions 

HASP/RTPM20 provides the following output functions at the remote 
station: 

e Dequeues blocked records received from VNET. 

e Identifies the device required for output of the records. 


e Deblocks and decompresses outfut records, queueing the images for 
printing, punching, or typing. 


e Prints, punches, and tyres the output records, as required. 


e Sets status flags, indicating backlog conditions on the output 
devices. 


Communication Functions 


ey ee ee Ce Oe Ge 


HASP/RTPM20 provides the following communication functions at the remote 
station: 


e Establishes and maintains synchronization with VNET. 


e Dequeves blocked input requests and transmits them to VNET (upon 
request from VNET). 


e Provides backlog status flags, indicating the station's ability to 
receive the various outrut streams from VNET. 


e Receives output from VNET and queues the blocked records for 
processing. 
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Operating Procedures 

This secticn provides information for starting and orerating the Model 
20 or IBM 2922 during the remote jok stream processing session. 

The initiation of a remote job stream processing session involves 
initial program loading of the HASP/RTPM20 program deck, establishment 
of the communication lines, and exchange of initial control information 
bketween VNET and the HASP/RTIPM20 program. The initial control sequence 


ends with the passing of the sign-on information from the remote 
station. 


INITIAL PROGRAM LOAD (IPL) 
The following steps should ke taken tc perform the initial program 
loading of the HASP/RTPM20 program deck: 

1. If the power is off, press POWER ON. 

2. Ready the HASP/RTPM20 deck in the supported card reader. (The last 
card of the deck should ke ktlank or a /*SIGNON card, as directed ky 
the installation). 

3. Ready the printer, punch, and console (as reguired). 

4. Set time sharing key down. 

5. Set the address/register data switches to one of the following: 
1F00 - 8K storage 
2FO00O - 12K storage 
3F00 - 16K storage 

€. Set the mode switch to PROCESS. 

7. Press LOAL. 


8. All the cards in the HASP/RTIPM20 deck are read, except the last 
card. Press reader START to read the last card. 


9. The IPL is complete when the last card is read. HASP/RTPM20 prints 
the /*SIGNON card, if present, followed by a VNET environmental 
recording error printout (if the contents of main storage remain 
unchanged since the last time the program was run). 


10. The BSCA indicator lights should show periodic transmit and receive 
activity. 


11. The remote station is now ready to communicate with VNET. 


ESTABLISHING A COMMUNICATION LINE 


The procedures for establishing communications with VNET are as follows: 


1. Ready the data set. This involves different actions, based on the 
type of data set. Readying nonswitched lines only requires that the 
data set CATA button ke pressed, if present. To ready a dial line 
data set, perform the following: 
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J 


ae Press the TALK kEutton, and lift the receiver off the data set. 
b. Dial the assigned number for the remote station. 


c. If the VNET line is available, the central system answers with 
a kigh pitched tone. Press DATA and hang up immediately; the 
data set is now ready. 


dad. If the VNET line is in use, a kusy signal is received. Hang 
up, and try again later, or dial an alternate communication 
line number. 


e. If the call is net answered, the VNET operator has not given 
the necessary ccrmrand to authorize use of that communication 
line. Contact the VNET operator and request that he issue the 
START command for your link. 


2. When requested by VNET, HASP/RTPM20 begins the initial control 
sequence. 


3. When the initial sequence is complete, the sign-on function is 
transmitted to VNET. HASP/RTPM20 "handshakes" with VNET until the 
processing of job streams actually Legins. 


OUTPUT PROCESSING 


The printing and punching cf remcte output is handled automatically by 
the VNET - HASP/RTPM20 system, except as controlled ky the remote 
Station cperator or VNET operator, via commands to VNET. 


INPUT PROCESSING 


Ceck submission can be initiated at any time, depending on the 
capabilities of the card reader/punch combination attached to the Model 
20. There is no restriction on when the operator can submit a deck 
stream with the following reader/punch combinations: 


1. 2501 Card Reader - 2560 Multi-function Card Machine (secondary 
feed) 


2. 2501 Card Reader - 1442 Card Punch 

3. 2501 Card Read - 2520 Card Punch 

4, 2560 Multi-Function Card Machine (primary feed) - 1442 Card Punch 

5. 2520 Card Read Punch - 1442 Card Punch 
The operator places the cards in the hopper. The reader stops just 
before reading the last card of each job stream. The operator should put 
more cards in the reader or pfress START on the reader, allowing the last 
card to indicate the end of the input stream. 
The input reader to HASP/RTPM20 is always considered "hot"; that is, the 
program is continually testing the reader and attempting to read cards. 
During this time the approrriate CARD I/O indicator on the CPU console 


is on (see Unit Record Error Procedures). This condition is not an error 
but indicates that HASP/RTPM20 is ready to send the next input. 
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OPERATING A COMBINATION CARD REAL PUNCH 


Cevices with single card paths for both read and punch functions are 
considered comkination reader/punch devices. When using these devices as 
combination devices, the operator must concern himself with the status 
of the device. The following are supported combination devices: 


« 2520 Card Read Punch 


e 2560 MFCM (read - primary feed) 
(punch - secondary feed) 


Note: These devices are not considered combination dévices when used in 
combinations listed previously under "Input Processing". 


Operating the 2520 Card Read Punch 
The 2520 has four basic status conditions that affect the operator: 

1. Neutral -- reader empty during necrmal program execution. 

2e Input -- reading normal input stream. 

3. Output -- punching ncrmal from VNET. 

4, Output Error recovery -- attempting to recover from punch errors. 


At IPL time the 2520 is in neutral status and may be treated as any 
reader device; the operator is at liberty to submit multiple input 
streams at any time. Any ;Llank cards wixed in the input stream are 
submitted to VNET as input. When HASP/RTPM20 recognizes an end-of-file 
(EOF), the 2520 reverts to the neutral status. 


When the 2520 is in neutral status, the operator may choose to ready the 
device with blank cards, thereby placing it in output status. If VNET 
has output waiting, HASP/RTPM20 responds immediately by punching the 
klank cards. However, after all punching is finished or if there is a 
pause due to low line speeds, the operator may not run the remaining 
cards out of the 2520 and ready it with input stream cards. The 
procedure for interrupting the output mode is as follows: 


1. Press STOP on the 2520. 


2- Remove the cards frow the hopper. (Do not run the cards out of the 
card path.) 


3. Place the input stream cards in the hopper and press reader START. 


4. If the punch is ktusy, the device continues punching until the input 
strear is encountered; then, the 2520 enters the input status. (it 
is not necessary to remove all blank cards from the hopper.) 


5. If the punch is momentarily idle, it is waiting for local commands 
from the console (if installed). The operator can cause the 2520 to 
pass one card through Ey typing on the console ".SR1" (start reader 
1). If several blank cards are in the hopper prior to the input 
stream, this command rust ke entered for each blank card. For 
configurations without consoles, the operator can simulate the .SR1 
command by setting data dial 2 to numerical value 2 and moving data 
dial 1 one position in either direction. Do not move dial 1 twice. 
Upon completion of the skip function, set data dial 2 out of 
position 2. 
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The 2520 is in error recovery status when a punch error occurs. 
HASP/RTPM20 attempts to repunch the record in error. If HASP/RTPM20 
encounters a nonblank card, a read error occurs (see Unit Record Error 
Procedures). The operator should run out the input stream cards using 
tke NPRO key, place one or more Elank cards in front of the input stream 
and ready the 2520. 


Operating the Combination 2560 MFCM 


The 2560 has two basic status conditions: 
1. Input -- submitting decks using primary feed and hopper. 
2- Output -- punching data from VNET using secondary feed. 


Blank cards, for punching, should always be in the 2560 secondary feed 
hopper during normal processing. HASF/RTPM20 periodically tests the 
primary feed for input stream cards. If input stream cards are 
encountered, the HASP/RTPM20 suspends the output status and submits the 
input stream to VNET. The cperator should always press STOP on the 
combination 2560 prior to loading the input stream in the primary feed 
hopper since HASP/RMTM20 cycles the feed mechanism when it tests for 
input stream cards. 


Entering Commands 


VNET commands, as well as local commands, may ke entered at the 2152 
operator's console. Any wessage entered at the 2152 keyboard and not 
recognized as a local command is transmitted to VNET for action. 
Although all ccmmands transmitted to VNET are listed on the VNET 
operator's console, only those designated as available to the remote 
user are acted upon. Local commands that are availakle to the 
HASP/RTPM20 operator Signal the status of the unit record devices. 
Figure 10 contains a list of all available local commands. 


Ba 
Command | Meaning/Comments | 
eSR1 [Start reader 1. This command | 
tells HASP/RTPM20 that the oper—-| 
ator has corrected a data check | 
condition and has made the card | 
reader ready to continue reading| 
the input stream (the first card| 
is a corrected version of the | 
card in error). This command is | 
also used to terminate the out— | 
put status of a combination | 
2520 card reader/punch. | 
| 

| 

| 

! 


Start punch 1. This command tells 
HASP/RTPM20 that the operator 

has removed the incorrectly 
punched card from the punch 
stacker (1442) and the punch is 
| ready. | 


a a a ee ee 


Figure 10. HASP/RTPM20 Local Commands 
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The operator should perform the following steps when entering ccmmands: 


1. Press the REQ button that is located to the right of the console 
typewriter keyboard. The request indicator (indicator marked "R" at 
the right of the REQ Eutton ) glows momentarily. 


2- When the froceed indicator comes on (indicator marked "P" below the 
request indicator), type in the command and press EOT. 


3. If a typing error is noticed prior to pressing EFOT, press CAN 
(cancel) and repeat step 2. 


4. If, after receiving a proceed indicator, no command is to be 
entered, type "." and press EOT. This is recognized as an invalid 
local command and is ignored. 


Commands are identified by a period (.) in the first type position. 
Except for the use of upper and lower case alphabetic characters, the 
commands must appear exactly as listed. No Elanks are allowed. 


Terminating a Session 


To terminate remote processing, the remote station operator should enter 
a DRAIN command or /*SIGNOFF card indicating that VNET should not 
initiate any additional remote output and should release the 
communication line (if switched) when the current print and punch 
streams are finished. The CATA light on the data set goes out, and BSCA 
enters a check condition. For nonswitched lines, VNET makes the line 
available and waits for an initial sequence request from the HASP/RTPM20 
program. Versions of HASP/RTPM20 that support console messages log UNIT 
CHECK on the console. The operator should check to see if printing and 
punching of output streams have successfully terminated and should press 
STOP on the CPU. To start a new session, the operator must perform the 
steps described previously starting with the Initial Program Load of 
HASP/RTPM20. 


Error Recovery 


The following sections indicate some common error conditions and the 
necessary steps for recovery from the errors. 


CCMMUNICATION ACAPTER ERRORS 


Due to the design of the synchronization technique fcr VNET remote 
stations, no errors are expected during a processing session. The 
unusual occurrence, therefore, of any error condition results from 
either a system or a communication facility malfunction or from 
operational conditions. Ir general, the display of error messages is 
cnly informational, because the station processor automatically 
initiates the appropriate recovery action. 
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A statistical summary of all errors iS maintained in the VNET 
Environmental Recording Takle, and a historical report is produced each 
time HASP/RTPM20 is loaded, unless storage has been cleared. 
Additionally, the occurrence of any error causes a deScriptive message 
to be displayed immediately on the console typewriter. 


Figure 11 indicates each possikle communication error, its meaning, and 
the recovery action taken. 


UNIT RECORD ERRORS 


Ac a result of unit record device errors that inhibit I/0, HASP/RTPM20 
ccentinuously tests the device, while performing other functions that can 
continue. The cperator is notified of device error by the CPU indicator 
panel as follows: 


1. Card I/O 1 -- 2501 Card Reader 


2. Card I/O 2 -- 2520 Card Read Punch or 2560 Multi-Function Card 
Machine 


a a a 
| Message | Meaning | Action Taken 


oe ee ee es eee 


[ Olrree00 | Block sequence check. A transmission block | 

| was duplicated or lost. | block is ignored. If a 
| | | lost block, VNET is 

| | rr = received Elock number | signaled to restart the 
| | ee = expected block number | stream. 

| 

| 


Re a, OES QO EY EEE CEES 


020C0000 | Negative reply received. A transmission block] The bad record is 


| was not correctly received by VNET. | retransmitted. 
[ ea a ee ee an ae ee 
O3rrrr00 | Unknown response received. An unrecognizable | VNET is requested to 
| control character was received from VNET. | retransmit the record. 
| | 
| rrrr = first character received (if rrrr is | 
| in correct sequence, ending sequence | 
| was kad). | 
05ss0000 Unit check. A check condition has occurred in| The failing operation is 


the communication adapter. retried. If a write 


SS = sense byte indicating type of check. the time of the error, the 
write is reissued; 
otherwise, VNET is 
reguested to retransmit. 


= overrun on write 
02 = parity check on write 
81 = overrun on read 
88 = lost data on read 
90 = tire out (no response received from 


VNET in three seconds) 
AO = transmission error 
= FOT received 


A a SS a SS SS EEE A ES SR a EE EGS GES GD RES ShcA GE ED 


Figure 11. HASP/RTPM20 Communication Adapter Error Messages 
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If a duplicate, the received 


operation was in progress at 


eee eee eee eee eC eC eS CC eee a Cae Cl 


3. Card I/O 3 — 1442 Card Punch 


4Y. Printer — 1403 Printer or 2203 Printer 


Indicators on the device control panel indicate the nature of the 


proklem. The operator shculd correct the error, according to procedures 


prescribed for the device, and then ready the device. HASP/RTPM20 
automatically resumes use of the device. 


Unit record errors that occur during I/O result in various program 


actions, appropriate to the operator message facilities available for 
irforming the operator and the nature of the error encountered. Figure 


—— 


Device-—Function | 


2 
2 


Action with Console 


01, 2520, 


5 1. Type error message. 
560 — read 


| 
| 
| 
| 2. Wait for .SR1 command. 
| 
| 


{ 1. Type error message’, 

| 

| 

{ 2. Wait for .SU1 command. 
| 

| 

| 


3. Repunch record in error. 


se es ee ee oe ee ee ee 


punch | 
| 2. Repunch record in error. 


2203, 1403 - {| Ignore error. 


Oh ee 


1. Ignore first error. 


device3, 


2152 — read | 1. Initiate reread. 


device3,. 


1Error messages are of tke fcrm: 0500000a UNIT CHECK, where a is the device 


address of the unit in error. 


eee eee 


2520, 2560 — | 1. Select out card in error. 


| 

| 

| 2. Wait on next attempt to use 
| 


tee SEE es EE Ge GE ee 


| 
| 2. Wait on next attempt to use 


nnn nn eee ee ee eee ne ne ee ee 


en 
Action without Console | 


1. STOP with device address in 
in ESTR reqister2, 


2. Reread when CPU started. 


1. STOP with device address in 
ESTR register?. 


2. When CPU started, repunch 
record in error. 


1. Select out card in error. 
2. Repunch record in error. 


Ignore error. 


Not applicable. 


ee SE es ee SS ee ee eS es es ee EE ce ee ei SS ss ee we ce ee ees ees 


Not applicakle. 


2Device addresses corresrfond to the CPU panel CARD I/0 indicator numkers. 


| 
| 
| 
3Console error indicator is cleared by pressing OFF LINE, then ON LINE. | 
ne | 


Figure 12. HASP/RTPM20 Action on Unit Record I/cC Fxecution Frrors 
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12 indicates the program action taken for each device supported by the 
system. When notified of the error via the 2152 console, the operator 
should: 


c 1. Note the address code in the error message (see Figure 12). 
2. Correct the error for "data check". 
3. Ready the device for prcgram retry of I/0. 


4, Type the appropriate command (.SR1, .SU1) to Signal HASP/RTPM20 
that the device is ready. 


Without the 2152 console, the program stops the CPU with the address of 
the device in the ESTR register. The operator should (without delay): 


1. Note the address of the device in the ESTR register. 


a 

2. Press STOP on the indicated device. 
3. Press START on the CPU to allow continuation of other functions. 
4. Correct the error for "data check", 

& 
5. Ready the device for fregram retry of I/0. 
REMOTE STATION RESTART 
In the event of an untimely interruption of the remote station operation 
(such as a machine, program, comrunications, or environmental failure), 
the remote station operator should notify appropriate maintenance 

—y personnel of the malfunction, save material that may be of use in 


determining the source of the failure, and (with the aid of the VNET 
operator) prepare for restarting the station, as follows: 


1. Notify the VNET operator of the failure and, if necessary, request 
his assistance in preparing for restart. 


2. Determine the current job that was being transmitted to VNET. (The 
VNET operator has a record of the deck currently being submitted to 
VNET.) The input stream, starting with that current deck, must be ~ 
resubmitted to VNET after restart. 


3. Determine the loss of data on the output devices ard inform the 
oe VNET operator to kackspace or restart the printer or punch, as 
necessary. (The VNET link should be made available for a 
subsequent session with the remote station or with other stations 
within the system.) 


: 4. When the remote station is available, restart the session beginning 
with the Initial Pregram Load of HASP/RTPM20. 


IEM SYSTEM/3 AND SYSTEM/32 AS REMOTE STATIONS 


The IBM System/3 Models 6, 8, 10, 12, and 15, and the IBM System/32 are 
(C Supported as remote work stations by VNET. 
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There are two types of MULTI-LEAVING Remote Jok Entry Work Station 
(MRJE/WS) support for the System/3 and System/32. The first, which is 
for the System/3 Model 10 card system only, applies to a program 
produced by VM/370 generation. This program is in the form of a card 
deck, which is punched out at the System/3 and must be loaded to enable 
communication with the host system. This is described in the section 
"TBM System/3 Model 10 Card System as a Remote Station". 


The second type of MRJE/WS support runs on System/3 Models 6, 8, 10, 12, 
and 15, and on the System/32. This support consists of a group of 
programs that support all System/3 or System/32 input and output 
devices, including disks and tape. This support requires the System/3 or 
System/32 Syster Control Program (SCP) and related MRJE/WS programs. 


Information describing MRJE/WS support for the System/3 is contained in 
the following manuals, wkich contain references to other System/3 SCP 
manuals. 


Os 


1 


System/3 Models 6, 8, 10, an 


IEM System/3 MULTI-LEAVING Remote Job Entry Work Station 
Support Reference Manual, Order No. GC21-7621 


Program Logic Manual, Order No. SY21-0544 


system/3 Model 15 


IEM System/3 MULTI-LFAVING Remote Job Entry Work Station 
Support Reference Manual, Order No. GC21-5115 


Program Logic Manual, Order No. S¥21-05521 


system/32 


The System/32 is supported with the following features: 
-- 5320 System Unit (Any Model A12 through B33) 
-- Binary Synchronous Communications Adapter (#2073) 
-- System Control Program (5725-SC1) 


Information describing support for the System/32 is contained in the 
fcllowing publications. 


IEM System/32 System Contrcl Programming Reference Manual, Order No. 
GC21-7593 


IEM System/32 Operator's Guide, Order No. GC21-7591 


IBM System/32 Data Communications Logic Manual, Order No. SY¥21-0551 
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The following section contains instructions for operating the IBM 
System/3 Model 10 card system equipped with a Binary Synchronous 
Communications Adapter, as a VNET MULTI-LEAVING remote station. 


Configuration Specifications 


The System/3 Model 10, with the following features, is suprforted as a 
VNET remote MULTI-LEAVING work station. 

The minimunr System/3 requirements are: 

e 5410 Central Processing Unit (any model) 

e Binary Synchronous Communications Adapter 

e EBRPCDIC Transmission code 

e Text Transparency 

e 5424 Multi-function Card Unit (any model) 


e 5203 Printer (any model) 


Supported features are: 


e 1442 Card Read Punch (RPQ 843175 on System/3 5410 CPU and RPQ 841205 
on 1442 Card Read Punch) 


e 5471 Printer Keyboard or 5475 Data Entry Keyboard 
e Universal Character Set on the 5203 Printer 
e Additioral Print positions for 5203 Printer 


e Any type or speed transmission line available for System/3 


Recommended features are: 


e 24 or 36 extra print positions on 5203 Printer (to provide standard 
VM/370 print line) 


e Universal Character Set and PN train on the 5203 Printer (to provide 
for standard VM/370 character set) 


e 5471 Printer-Keyboard (as a remote operator console) 


The following features are incompatible with VM/370 support and should 
not be specified: 


e Multi-Point Network Attachment (#9482) 
e USASCII Transmission Code (#9061) 


e Station Selection (#7477) 
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All features not specifically prohibited may be attached to the System/3 
but are not supported by the HASP System/3 station processor program. 


Remote Terminal Processor (RIP) Program 


A special program exists for the IBM System/3 Model 10 card system which 
allows it to operate as a remote work station for MULTI-LEAVING 
operating systems such as HASP and ASP. For details on generating the 
appropriate work station program, see the publication OS/VS2 HASP II 
Version 4 System Programmer's Guide, Order No. GC27-6992. A System/3 
under control of this prograr and communicating with VNET can be viewed 
af a logical extension of the VM/370 spooling system. This program 
(HASP/RTPSYS3) performs input, output, and communications functions. 


HASP/RTPSYS3 can read, print, and punch data concurrently, depending on @ 
the options selected by the installation and the capabilities of the 
unit record devices. 


Due to the use of blocking and character compression to minimize line 

transmission time, the speed at which the System/3 unit record devices 

operate is dependent on the data being transmitted and the number of ® 
concurrent functions. Certain job mixes, because of their data 

characteristics, enable HASP/RTPSYS3 to operate the unit record devices 


at near full speed. Other jok mixes cause the devices to operate in 
short bursts because of ccntention on the communications line. 


INPUT FUNCTIONS 


HASP/RTPSYS3 provides the following input functions at the remote J 
station: 

e Reads from the attached card reader(s). 

e Recognizes operator requests, and reads from the attached console. 


e Identifies, compresses, and blocks card images and commands for 
transmission to VNET. 


e Queues Elocked records fcr transmission to VNET. 


OUTPUT FUNCTIONS 


& 
HASP/RTPSYS3 provides the following output functions at the remote 
station: 
¢ Dequeues blocked records received from VNET. ‘ 
e Identifies the device required for output of the records. 
e Deblocks and decompresses outfut records, queueing the images for 
printing, punching, or typing. 
e Prints, punches, and tyres the outfut records, as required. 
e ate status flags, indicating backlog conditions on the output J 
evices. 
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CCMMUNICATION FUNCTIONS 

HASP/RTPSYS3 provides the following communications functions at the 
remote station: 

e Establishes and maintains synchronization with VNET. 


e Dequeues Elocked input requests and transmits them to VNET (upon 
request from VNET). 


e Provides backlog status flags, indicating the terminal's ability to 
receive the various output streams from VNET. 


e Receives output from VNET and queues the blocked records for 
processing. 


Qperating Procedures 


This section describes normal operation procedures for the System/3 as a 
Remote Job Entry station. To start a Remote Job Entry session, the 
cferator should load the Remote Station Processor (HASP/RTPSYS3) program 
deck, establish a connection between System/3 and the central comuputer, 
and Sign on. 


INITIAL PROGRAM LOAD (IPL) 
The HASP/RTPSYS3 program deck is either a deck of 96-column cards or a 
deck of 80-column cards. 
To load the 96-column load deck: 
1. Put the deck in the rightmost card hopper of the MFCU. 
2. Press START on the MFCU. 


3. Press PROGRAM LOAD on the System/3. (For disk systems, the program 
load selection now must point to MFCU.) 


4. Press START on the printer. 


To load the 80-column load deck: 
1. Raise the CE controls cover on the System/3. 
2. With the CE Mode Selector at PROCESS, press SYSTEM RESET. 
3. Turn the CE Mode Selector to ALTER STOR. 
4. Set the data knobs to C2, and press START once. 
5. set the data knobs to 01, and press START once. 
6. Set the data knobs to 00, and press START once. 
7. #%$Set the data knobs to 00, and press START once. 


8. Set tke data knobs to 31, and press START once. 
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9. Set tke data knobs to 54, and press START once. 
10. Set the data knobs to 00, and press START once. 
11. Set tke data knobs to 03, and press START once. 
12. Set the data knobs to F3, and press START once. 
13. Set the data knobs to 51, and press START once. 
14. Set the data knobs to 01, and press START once. 
15. Set the data knobs to F1, and press START once. 
16. Set the data knobs to 52, and press START once. 
17. Turn the CE Mode Selectcr to PROCESS. 
18. Press SYSTEM RESET. 
19. Close the CE Controls cover. 
20. Put the 80-column load deck in the 1442. 
21. Press START on the reader, the printer, and the System/3. Cards 
begin reading. 
22. When the reader ready light goes out, press START on the reader. 


Midway through the program deck, the reader stops reading and the 
printer starts printing the VNET Environmental Recording and Editing 
Program (HEREP), a standard feature of HASP/RTPSYS3. The information 
printed is the content of certain errer counters; these counters contain 
a record of the unit checks that occurred during the last remote station 
session. If the counters have been destroyed, one line is printed: 


HEREP COUNTERS HAVE EFEN ALTERED. 


In any case, program loading automatically resumes after printing is 
complete. 


Program loading has completed satisfactorily if, when the cards stop 
reading, the console indicator [T TERM READY is ON and either the hopper 
is empty or the first card in the hopper is not an EOR or /*SIGNON card. 
Decks or Flank cards may ke stacked behind the program deck. If DDT 
TERM READY is not ON, the last card of the program deck was not an EOR 
or /*SIGNON card, or a card read error occurred. To correct a card read 
error, follow the procedure under halt code F3 in the IBM System/3 Card 
System Orerator's Guide. Ready the hopper, and depress the START key 
(on dual programming systems, the PROGRAM LEVEL ONE RESET key) if halt 
code F3 is displayed. 


If the DT TERM RFADY light is ON and the hopper contains an EOR or 
/*SIGNON card, the operator should remove the cards from the primary 
hepper, press STOP and then NPRO on the reader. The card that was 
stacked when NPRO was pressed is either an EOR or a /*SIGNON card. 
Reload the program deck, making sure that it ends with either the 
correct /*SIGNON card or a single EOR card. 
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ESTABLISHING A COMMUNICATION LINE 


The next step in initiating a remote session is establishing a line 
connection between the System/3 and VNET. The VNET operator should 
already have issued the VNET command START linkid, where linkid is the 
lccation identifier associated with the System/3. 


If the communication line is nonswitched, make sure that any controls on 
the line's data set are in the DATA position. The System/3 automatically 
establishes cormunication with VNET. 


If the communication line is switched, pick up the data set's telephone 
handset and depress the data set's TALK Eutton. Dial the proper 
telephone number and listen for the ring. When the ring is answered 
(automatically ky VNET) you will hear a high-pitched tone, followed by 
Silence. CDepress the data set's DATA key and hang up the handset. The 
System/3 initiates communications with VNET and autcmatically sends it 
the /*SIGNON card. As the /*SIGNON card is being sent, the message: 


COMMUNICATIONS ESTABLISHED 


prints on the 5471 Printer-Keykoard and on the 5203 Printer (if the 5203 
is ready). 


If the System/3 has the Auto-Call feature and the /*SIGNON card (or the 
default /*SIGNON card, if not overridden) specifies a telephone number, 
leave the data set in AUTO. The System/3 automatically dials the 
required telephone numker. When the numker answers, the System/3 
automatically signs on. 


If the call is not answered, or if the System/3 halts with halt code CA 
(call aborted) while trying to auto-call, the trouble is most likely 
that an incorrect telephone number was dialed or specified on the 
/*SiGNON card. It could also ke that the VNET operator did not start the 
correct line. In the latter case, contact the VNET operator and request 
trat he issue the correct START command for your link. 


An auto-call halt CA can occur if the called number is busy. In that 
case, depress the console START (or PROGRAM LEVEL ONE HALT RESET) key to 
repeat the autc-call or redial manually. 


CUTPUT PROCESSING 


The remote operator need only press START on the printer to allow 
printing to occur. Once a file has reached VNET, printing starts 
automatically. When a user's frinted output is complete, VNET queues 
that user's punched output (if any) for processing. 


eee GES oe 


1. At initial program load time, the system checks indicators of the 
5203 to determine which print chain is mounted. If the indicators 
Show a 48 character-set chain, the system assumes character 
arrangement IC; otherwise, it assumes character arrangement PN. 


2. At initial program load time, the system sets the number of print 
lines per page to 66 (may be different for each installation). 


Appendix C: Remote Terminals and Stations 223 


For dual-carriage printers, the system uses only the left carriage; 
the operator must not press the RIGHT CARRIAGE RESTORE key. 


3. At initial program load time, the system sets line rumbers for 
programmed page skifring. These line numbers are provided to 
Simulate the carriage tape control normally encountered in VM/370. 
A skif to carriage chanrel 1 results in a page eject; a skip to 
channel 12 stops 5 lines from the bottom of the page; and a skip to 
any other channel results in no page movement. Carriage tape 
channels may, however, be defined differently for each 
installation. 


INPUT PROCESSING 


The remote operator places into a card hopper (either 5424 or 1442 card 
reader) a stack cf one or more decks and makes the card hopper ready. 
The system reads the first card, finds it punched, and requests 
permission from VNET to start sending a job stream. When the system 
receives permission from VNET, it continues reading cards and sending 
them to VNET. 


If the remote operator is reading cards on the 5424, he may use eith 

er card hopper. The last card of his stack of decks must be a /*EOF 
card (the characters /*EOF punched into columns 1-5); this card 
instructs the system to send an end-of-job-stream indicator to VNET and 
to make the card hopper dormant. 


If the remcte operator is reading from the 1442, he ends the job str 
eam ky presSing START when the hcpper is empty. No special 
considerations apply to preparing or reading 80-column cards. 


OPERATING A COMBINATION CARD REAL PUNCH 


Devices with single card paths for both read and punch functions are 
considered comkinaticn reader/punches, if they are supported for both 
functions. The following are supported combination devices on the 
System/3: 


e 5424 Multi-function Card Unit 
e 1442 Card Read Punch 


Operating the 5424 Multi-function Card Unit 


1. Either hopper of the 5424 can be used as a reader or a punch. When 
a previously dormant 5424 hopper reads a punched card, it becomes a 
reader. It remains a reader until it reads a /*EOF card; it then 
goes dormant with the /*FOF card in the wait station. 


2. When a previously dermrant 5424 hopper reads a blank card, it 
becomes a punch. It remains a punch until it has completed 
punching all decks queued for it. If no decks are queued for it, 
the operator can make the hcpper dormant by removing the blank 
cards from it. 
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8. 


The 5424 can read cards much faster than it can punch cards; 
therefore, to increase card throughput, the system performs card 
reading preferentially over card punching. When using both 
hoppers, one as a reader and one as a punch, punching tends to 
proceed intermittently. 


Though the 5424 has two hoppers, it has only one card path. For 
error recovery purpceses, the system ensures the card path is empty 
before switching hoppers. Therefore, if the operator is using both 
hoppers as readers, cr koth as punches, the system tends to process 
cards from one or the other of the hoppers, rather than dividing 
its time evenly between them. 


Each klank card to ke punched is read before it is punched, to make 
sure it is blank. A card that is not blank is stacked in the read 
Stacker for the hopper from which it came. 


Stacker selection is as follows: 


Condition Stacker 
Reading frem primary 1 
Punching frem primary 2 
Punching from secondary 3 
Reading from secondary iT} 


When preparing 96-column cards for the input deck, the operator 
should avceid punching column 81, since the system makes special use 
of this column. In any case, the system only transmits the contents 
of columns 1-803; columns 82-96 are completely ignored. If the 
RMTGEN parameter &S30BJDK was set to 1 when HASP/RTPSYS3 was 
generated, the system inspects column 81. If that column contains 
the character "1", the system assumes that the card contains a 
hexadecimal image of the first 40 bytes of an 80-column card. It 
reads the next card, checks for a "2" in column 81, combines the 
cards into an 80-column card image, and transmits the card image. 
No checks are made for validity of hexadecimal characters. If a "2" 
card does not follow a "1" card, the "1" card is ignored. 


Certain punching restrictions are placed on the 5424. For all 
systems, if column 1 is x'6A* (12-11 punch.on an 80- column card) 
the system recognizes a VNET job separator card, extracts the spool 
file number to punch a System/3 ‘job separator card, and ignores the 
rest of the card. If the RMTGEN parameter &S30BJDK was specified as 
1 when HASP/RTPSYS3 was generated, then the system recoqnizes a 
card image of an object deck and punches two 96-column cards with a 
hexadecimal representation of the card; see Item 7 above. If the 
RMTGEN parameter &S396COL was specified as 1, the system recognizes 
the left 48 columns (if column 80 is odd) or the right 48 columns 
(if column 80 is even) of a 96-cclumn card; in this way all 96 
columns of a System/3 card can ke punched. This feature is used to 
create the System/3 Remote Station Processor program deck, which is 
punched in System/3 load mode. 


For a detailed description of the RMTGEN macros used in generating the 
Remote Station Processor program, see the OS/VS2 HASP II Version 4 
System Programmer's Guide. 


1. 


Gee eee ee 


When a previously dormant 1442 reads a punched card, it becomes a 
reader. It remains a reader until the operator presses the START 
button after the hopper kecomes empty (or until it reads a /*EOF 
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card); it then becomes dormant. If it became dormant because the 
operator pressed the START Eutton with no cards in the hopper, it 
also runs out the cards in its feed path. 


2e When a previously dormant 1442 reads a blank card, it becomes a 
punch, It remains a punch until it has completed punching all files 
queued for it. Only after all queued decks have been punched can 
the oferator safely remove cards from the 1442 hopper; with the 
hopper empty and no more punching to do, the 1442 becomes dormant. 
Press the NPRO button tc stack the two blank cards remaining in the 
card feed path into the right stacker. 


3. All cards processed Ly the system are stacked into the left 
stacker. 


Entering Commands 


If the System/3 includes a 5475 Data Entry Keyboard or a 5471 
Printer-Keykoard, the keykoard can Le used to enter commands. Otherwise, 
punch the commands on cards and enter them through a reader, exactly as 
if they were joks. 


The only valid commands from a remote station are a subset of the VNET 
ccmmands described previously under "Remote Station Operator Commands." 


ENTERING CCMMANDS FROM THE 5471 PRINTER-KEYBOARD 


To type a command to VNET, press the REQ key. If the system can 
immediately allow you to type a command, the PROCEED light goes on; 
otherwise the REQUEST PENDING light goes on. You can press the REQ key 
while you are typing a command, while the system is typing a message to 
you, or while the console is dormant. 


When the PROCEED light comes on, start typing the command. If you make a 
mistake, press the CANCEL key and start typing again. 


When you are finished typing, press either the END key or the RETURN 
" .: their functions are identical. The command is transmitted to VNET, 
a - it is executed (if valid) and printed along with the remote 

~ * gn number on the VNET operator's console. 


If the command contains 120 characters, the remote station automatically 
performs the END key function when the 120th character is typed. 


The 5471 does not type messages if the end-of-forms switch is on. When 
the 5471 runs out of forms, reload forms, press the REQ key, and then 
press the END key. The 5471 resumes typing if there are messages to be 
typed. 


ENTERING COMMANDS FROM THE 5475 DATA ENTRY KEYBOARL 


To type a command to VNET, merely start typing cn the 5475 Data Entry 
Keyboard. The keyboard is always "alive." After the first character is 
typed, the column indicator becomes active and displays "02", the 
position of the character to be typed next. If you make a mistake, 
depress the FLL EFRASE key; the column indicator displays "01" and you 
can start typing again. 
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When you are finished typing, depress the REL key to transmit the 
command to VNET. When the column indicators go dark, begin typing 
another command. If you type a command of 120 characters, the system 
automatically performs the REL key function when you have typed the 
120th character. 


ENTERING CCMMANCDS FROM CARTS 


To send commands to VNET from a card reader, punch the commands, one per 
card, Starting in column 1. Put one or more commands cards, followed Ly 
a /*EOF card, into an availakle card hopper and fress START. The 
commands are transmitted along with the remote staticn number and reader 
number to the VNET operator's console. 


The /*EOF control card consists of the characters "/*EOF" punched in 
cclumns 1-5. This control card must ke the last card read by an MFCU 
hopper when the hopper is reading, whether decks, commands, or just a 
/*SIGNOFF card is being read. This card may optionally be used on the 
1442 Card Read Punch, but the recommended 1442 procedure is as stated 
previously. 


The FOR control card consists of the characters "EOR" in card columns 


2-4. It is used instead of the /*SIGNON card when the default /*SIGNON 
card, assembled into the HASE/RTPSYS3 deck, is not to be overridden. 


SYSTEM/3 LOCAI CCMMAND FROCESSING 


If the System/3 Remote Station Processor programs include the local 
command facility, you can issue commands to be executed locally ky the 
System/3. Place a card containing the command into any dcrmant card 
hopper and press START. Do not use a /*EOF card. 


For each command, the command name starts in column 1 and is followed Ly 
the operand field. 


Command completion is indicated ky one of the following messages, 
printed in the same place as error messages: 


CODE0000 Command completed satisfactorily 
CODE0001 Syntax error in command 


CCDE0002 Operand value error in command 


A /*CARRIAGE command defines printer carriage information. The operand 
field has the format: 


a re 
| {L=forms—-length} {,chan=line—no} | 
| { ,chan=lin—no... ] | 


(a ee eS ee a ea Ss ee a see 
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wheres 


forms-length is the number of print lines on a page of forms (it must 
not be greater than 112). 


chan is the carriage-channel number (it must be between 1 and 
12). 


line-no is the line numker at which forms skipping stops for the 
indicated carriage channel (it must not be greater than 
forms-length). 


Notes: 
1. The /*CARRIAGE command is effective as soon as it is read in. 


2. Specification of the L= operand destroys all previous carriage 
channel settings. 


Terminating a Session 


When you are finished using the System/3 aS a Remote Job Entry station, 
put into an availakie hopper the two cards: 


/*SIGNOFF 
/*EOF 


and press START on the card reader. 


The /*SIGNOFF card tells VNET to disconnect the communication line after 
it has finished sending the current print and punch streams to the 
System/3 and after it has finished receiving the current deck from the 
System/3. That is, VNET disconnects when all currently operating 
functions are complete. If you sign off before VNET has started printing 
or punching some, or all of your files, VNET saves the output for 
transmission to your station the next time you sign on with the same 
remote station identification. The DRAIN command can alternatively be 
used to perform the same function. 


When VNET finally disconnects the communication line, the System/3 
communication adapter gets a time-out error every three seconds for 
about 20 seconds; then the LATA light on the data set telephone goes 
out. When the System/3 is dormant, press the STOP button on the console 
to stop the customer meter from running. The current RJE session is now 
ended. 


Error Recovery 


Two general classes of errors are defined in the System/3 Remote Station 
Processor: communication errors and unit record errors. For either type 
of error, the system generates an 8-character error message. If the 
system has a 5471 console, error messages are typed on it as they occur. 
If the system does not have a 5471 console, error messages may or may 
not be printed on the 5203 printer, depending on how the Remote Terminal 
Processor program was generated. The format of all error messages is: 


ttxxxxuu 
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where tt is the message type, xxxx is additional error information, and 
uu is the device on which the error occurred. The correspondence between 
uu and device is as follows: 


Device uu 
BSCA 00 
1442 05 
5203 OF 
5424 OF 


COMMUNICATION ADAPTER ERRORS 


The communication technique used by VNET prevents BSCA errors during a 
processing session. Therefore, any BSCA error that occurs while the 
oferator is signed on is an unusual condition, resulting from system or 
cemmunication facility malfunction or operational conditions. For all 
ESCA errors shown in Figure 13, the ESCA processor within the System/3 
Remote Terminal Processor automatically takes corrective action. The 
oferator should regard all ESCA error messages only as informational 
messages. 


UNIT RECORD ERRORS 


Unit record error messages are provided for errors on the 1442 Card Read 


ce—-——a—S ee > > Oe oe Oe  e —?:—_ OO 


wae, ES ee 


BSCA status indicators are ssss, 


For example; 


is taken to continue or 
restore communication. 


Punch (an RPQ device), the 5424 Multi-function Card Unit, and the 5203 . 
Printer. 

a norma a a aR ECE | 

| Message | Meaning | Action Taken | 
a ee 

| O1rree00 | A block sequence check occurred. A [Duplicate transmission tlocks | 

| transmission block was duplicated or | are ignored. Lost | 

| lost. rr is the received block number | transmission blocks cause | 

| | and ee is the expected block number. { automatic job restart. | 

| | Both rr and ee range from x'80!' | | 

| { to X'8F', | | 

| 02000000 | The System/3 received a negative |The transmission tleck that | 

| | acknowledgment (NAK) from VNET. | was negatively acknowledged _ | 

| | | is retransmitted. | 

{ Same ——S Salter Panevan! =e a Fa en es ne ee SE 

| O3rrrr00 {| The transmission block received by {The System/3 sends a NAK | 

| the System/3 had an unrecognizable ! to VNET, which then: | 

{ starting or ending sequence. The { retransmits the block. | 

| starting sequence is rrrr; if it is | | 

{ correct, the ending sequence is in | | 

{ error. | | 

eee eee oa ee ee eS earn: — 

5ssss00 | The Systemys3 BSCA has a unit check. The [The appropriate action | 

| 

| 

| 

| 

| 

| 

| 

| 

| 


8000 denotes a timeout error 
8400 denotes a timeout error with 
akortive disconnect 
ener heer ea nN SS a ge ee) ee 
Figure 13. HASP/RTPSYS3 Communication Adapter Error Messages 
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5424 Multi-function Card Unit (MFCU) 


The only MFCU error message is: 
O5ssss0OF 
where; 
ssss represents the MFCU status indicators 


In all cases, operator intervention is required. The operator should 
check the MFCU control panel to determine the card hopper to which the 
error message applies. 


Code Meaning 
PRI The primary (rightmost) card hopper needs attention. 


SEC The secondary (leftmost) card hopper needs attention. 


The system attempts to perform its previous operation when the operator 
has cleared the error condition: if it was reading when an error 
occurred, it tries to read the same card again; if it was punching, it 
tries to punch again. Therefore, if the 5424 was punching, the operator 
should throw away the last card punched; if the 5424 was reading, he 
should place the last card read in the hopper again, so the system can 
reread it. First, however, he must lift the cards out of the indicated 
hopper and press the NPRO key to clear the error condition. 


5203 Printer 


The only 5203 error message is O5sSSSSOE, where "ssss" represents the 
5203 status indicators. If any error light is on at the 5203 control 
panel, the operator must correct the condition and press printer START. 
The system automatically retries printing when an incrementer failure or 
print check occurred. 


1442 Card Read Punch : 


The only 1442 error message is 05ssss05, where "ssss" represents the 
Status indicators. The system recovers from 1442 errors the same way it 
recovers from MFCU errors. The operator should perform the action 
indicated ky the 1442 error lights; then, throw away the last card 
punched or place the last card read back in the hopper and press START. 


REMOTE STATION RESTART 


In the event of an untimely interruption of the remote station operation 
such as a machine, program, communications, or environmental failure, 
the remote operator should notify appropriate maintenance personnel of 
the malfunction, save material which may ke of use in determining the 
source of the failure, and with the aid of the VNET operator, prepare 
fcr restarting the station as follows: 


1. Notify the VNET operator of the failure and, if necessary, request 
his assistance in preparing for restart. 
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2. Determine the current deck that was being transmitted to VNET. (The 
VNET has a record of the current deck being submitted to VNET.) The 
input stream starting with the current job must be submitted to 
VNET after restart. 


3. Determine the loss of data on the output devices and inform the 
VNET operator to kackspace cr restart the printer or punch as 
necessary. (The VNET link should be made available for subsequent 
session with the remote station cr other stations within the 
system.) 


4. When the remote terminal is available, restart the session 
beginning with the Initial Program Load of HASP/RTPSYS3. 


IBM 1130 SYSTEM AS A REMOTE STATION 


ae Oe aw 


The following section contains instructions for operating an IBM 1130 
System, equipped with a Binary Synchronous Communications Adapter, as a 
VNET MULTI-LEAVING remote station. 


Configuration Specifications 


Any model of the 1130 (except Models 4A and 4B) with at least 8K words 
of storage, the Synchronous Communications Adapter, and any card reader, 
may ke used as a VNET remote station. All standard readers, printers, 
and punches available for the 1130 system are supported in any 
combination. The console printer/keykoard is supported as a limited 
remote operator console. Any standard communication line (switched or 
nonswitched) of any speed is supported. The RPQ feature that allows the 
use of high-speed communication facilities is not supported. 


Remote Terminal (RTP) Processor Program 


A special program exists for the IBM 1130 that allows it to operate as a 
remote workstation for MUITI-LEAVING operating systems such as HASP and 
ASP. For details on generatino the appropriate workstation program, see 
the publication OS/VS2 HASP II Version 4 System Programmer's Guide, 
Order No. GC2776992. An 1130 System under control of this program and 
ccemmunicating with VNET can be viewed as a logical extension of the 
VM/370 spool system. This program (HASP/RPT1130) performs input, output 
and communication functions. 


HASP/RTP1130 can read, print, and punch data concurrently, depending on 
the options selected by the installation and the capabilities of the 
unit record devices. 


Cue to the use of blocking and character compression to minimize line 
transmission time, the speed at which the 1130 unit record devices 
operate is dependent on the data being transmitted and the number of 
concurrent functions. Certain job mixes, because of their data 
characteristics, enable HASP/RTP1130 to operate the unit record devices 
at near waximun speed. Other job mixes can cause the devices to operate 
in short kursts because of contention on the communications line. 
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INPUT FUNCTIONS 

HASP/RTP1130 provides the following input functions at the remote 
Station: 

e Reads from the attached card reader(s). 

e Recognizes operator requests, and reads from the attached console. 


e Identifies, compresses, and blocks card images and commands for 
transmission to VNET. 


e Queues blocked records for transmission to VNET. 


OUTPUT FUNCTIONS 

HASP/RTP1130 provides the following output functions at the remote 
station: 

e Dequeues blocked records received from VNET. 

e Identifies the device required for output of the records. 


e Deblocks and decompresses outfut records, queueing the images for 
printing, punching, or typing. 


e Prints, punches, and tyres the outfut records, as required. 


e Sets status flags, indicating backlog conditions on the output 
devices. 


CCMMUNICATION FUNCTIONS 

HASP/RTP1130 provides the following communication functions at the 
remote station: 

e Establishes and maintains synchronization with VNET. 


e Dequeues Elocked input requests and transmits them to VNET (upon 
request from VNET). 


e Provides backlog status flags, indicating the terminal's ability to 
receive the various output streams from VNET. 


e Receives output from VNET and queues the blocked records for 
processing. 


OFERATING FROCELCURES 


The following sections provide information for initiating and operating 
the HASP/RTIP1130 program during the remote job stream processing 
session. 


The initiation of a remote jok stream processing seSsion involves 
initial progran loading of the HASP/RTP1130 program deck, establishment 
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ry 


ow 


of the communication lines, and exchange of initial control information 
ketween VNET and the HASP/RTP1130 program. The initial control sequence 
ends with the passing of the sign-on information from the remote 
station. 


Initial Program Load (IPL) 


The following steps should ke taken to perform the initial program 
loading of the HASP/RTP1130 program deck: 


1. 


86 


Ready the HASP/RTP1130 deck in the primary card reader (do not 
place decks behind the HASP/RTP1130 deck). If two cards readers 
exist, be sure the second is not in ready status. 


Ready all printers. 
Set the STR/ESC switch to BSC. 


Set the line speed ccntrol to the appropriate value (1200, 2000, 
2400, etce). 


Verify that the rotary CPU control switch is set to the RUN 
position. 


Press IMM STOP, RESET, and PROGRAM LOAD on the 1130 console. 


After the last card kas keen read, the card reader goes out of 
ready status. Ready the card reader (press START on the reader 
until it becomes ready) and press START on the 1130 console. The 
last card should be the END card of the HASP/RTP1130 deck, a 
/*SIGNON card or a REP card. All unidentified cards are ignored. 


Estaklish the communications line. 


Notes: The message DATA SET NOT READY is printed after the execution 
of Item 7 if the data set is not ready and estaklishing the 
communications line is not possikle. 

Processing can then ktegin in the full MULTI-LEAVING mode. 


Establishing a Communication Line 


The procedures for establishing communications with VNET are as follows: 


1. 


Ready the data set. This involves different actions, depending on 
the type of data set. For nonswitched lines when the BSC RDY 
indicator is on, no action is required. Certain nonswitched lines 
require that the data set DATA kutton be pressed. To ready a dial 
line data set, perform the following: 


a. Press the TALK Eutton and lift the receiver on the data set. 
b. Dial the assigned numker for the remote station. 
c. If the VNET line is available, the central system answers with 


a high pitched tone. Press CATA and replace the receiver 
immediately (the data set is now ready). 
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d. If the VNET line is in use, a busy Signal is received. Replace 
the receiver and try again later, or dial an alternate 
communications line numker. 


e. If the call is not answered, the VNET operator has not given 
the necessary VNET command (START) to authorize use of that 
ccemmunication line. Contact the VNET operator and request that 
he issue the START command for your link. 


2. When the data set is ready, the BSC RDY indicator is on. When 
requested, HASP/RTP1130 kegins the initial control sequence. The 
REC and TSM lights alternate during normal operation. 


3. When the initial sequence is complete, control information is 
transmitted to VNET and “handshaking" (with the REC and TSM lights 
alternating) continues. In addition, the message: 


COMMUNICATION LINE ESTABLISEED 


is printed on the console typewriter. 


CUTPUT PROCESSING 


The printing and punching cf remote output is handled automatically by 
the HASP/RTIP1130 system, except as controlled ky the remote station 
operator or VNET operator via commands to VNET. 


Output Processing on the 1442 Card Read Punch - 


A system with the 1442 defined as a punch-only device requires no 
operator action other than a ready condition and Erlank cards in the 
hopper. 


INPUT PROCESSING 


Submissicn cf card decks can be initiated at any time, depending on the 
capabilities of the card reader/punch attached to the 1130 System. 


The 2501 Card Reader allows the cards to ke placed in the hopper as 
desired. The reader stops after reading the last card in the hopper and 
the message INTERVENTION REQUIRED ON 2501 is printed on the console 
printer. The operator may then press START on the reader to terminate 
the input stream or load more cards in the hoprfer, press START and 
continue the input stream. The intervention message is typed whenever 
the 2501 goes from a ready condition to a not ready condition. 


The input reader to HASP/RTP1130 is considered always "hot"; that is, it 
is continually testing the reader and attempting to read cards. 
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Input Processing on the 1442 Card Read Punch 


The function of the 1442 Card Read Punch is defined via operator action 
at the keykoard/console. Initially, the 1442 card Read Punch is 
considered to ke a card reader. When punch data is transmitted to the 
1130 System, a message is printed: 


PUNCH PROCESSOR WAITING FOR 1442 


The operator may then define the 1442 as a punch by entering the 
ccmmand: 


~DPUNCH ( or .DP) This specification is necessary for each job that 
transmits punch data to tke station. 


Once defined as a reader Ly issuing the command 
eCREALCER (or .DR) 


the 1442 retains the assignment until a .DPUNCH is given. As a reader 
the 1442 operates in the same manner as the 2501 Card Reader. 


Note that during input processing on the 1442 Card Read Punch: 


e The .CPUNCH and .DREALCER commands result in no action if the opposite 
function is active at the time the command is issued. 


e Defining the 1442 Card Read Punch as a punch with input cards in the 
hopper and punch data available from VNET results in the destruction 
of data in the input cards. 


ENTERING COMMANDS 


VNET commands, as well as local commands, may Le entered at the remote 
station's console. Any message entered at the keyboard, which is not 
recognized as a local command, is transmitted to VNET for action. 
Although all ccmmands transmitted to VNET are listed on the VNET 
orerator's console, only those designated as being available to the 
remote user are acted upon. 


Entering VNET Commands 


The remote station operator should perform the following steps when 
entering VNET commands: 


1. Press the INT REQ button which is located to the right of the 
console typewriter keykoard. 


2. When the K.B. Select indicator comes on, type in the command, and 
press EOF. 


3. If a typing error is noticed before pressing EOF, press the ERASE 
FIELD key, and repeat step 1. 


Note that the EACKSPACF key is processed in the same manner as the ERASE 
FIFLD key. 
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Entering Local Commands 


The following local commands can be entered at the remote station's 
console: 


e-CR Defines the combination 1442 Card Read Punch as a reader. tThis 
definitior remains in effect until a .DP command is entered and 
accepted. 


eCP Defines the combination 1442 Card Read Punch as a punch. This 
definition remains in effect for one output only. The function next 
assigned is dependent on the entering of another .DP or .DR. 


Local Commands are identified by a period in the first available type 
position. No klanks are allowed in the Lody of a command. Acceptance of 
a console command is sSignaled Ly the message: 


OK 
Rejection is signaled Ly the message: 


WHAT? 


TERMINATING A SESSION 


To terminate remote processing, the remote station operator can send a 
/*SIGNOFF card through the card reader input stream or issue the DRAIN 
command. This tells VNET not to initiate the sending of any more remote 
output and to release the communication line (if DIAL) when the current 
print or punch stream is finished. The RDY light on the data set goes 
out, and an SCA log message Code 3 is released periodically. The 
oferator should ensure that printing and punching of output streams have 
successfully terminated and then press STOP on the CPU. To start a new 
session, the operator must perform the steps described previously, 
starting with the Initial Program Load of HASP/RTP1130. 


ERROR RECOVERY 


The following sections indicate some of the common error conditions that 
can arise and the necessary steps required for recovery. 


Communications Adapter Frrors 


Due to the design of the synchronization technique for VNET remote 
stations, no errors are expected during a processing session. The 
occurrence, therefore, of any error condition is an unusual condition 
resulting from either system or communication facility malfunction or 
operational conditions. In general, the display of error messages is 
only informational, since HASP/RTP1130 will automatically initiate the 
appropriate recovery action. A list of error messages that may be 
displayed on the console printer is shown in Figure 14. 
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MOR ce indi RIE CE EREEEe Et ce Cite 


Message | Meaning | Action Taken 


a 


SS RA CN AOE I OE CEES aS 


If duplicate, the received 
block is ignored. If the 


FFrree00 Block sequence check. A transmission kLlock | 
| 
| block is lost, SML is 
| 
| 


| 

| 

| 

was duplicated cr lost. | 
| 

| rr = received klock numker Signaled to restart the job. | 

| = expected block number | 

ee eg ie eae A a NC eo ee aE ee ee a ee —— | 

02dddd00 | Abnormal read complete. The number of bytes | SML is requested to [ 

| requested have been read, but no end sequence| retransmit the record. [ 

| was detected. | | 

O3ddddC00 | Received timecut while attempting to | SML is requested to = 

| synchronize an initial sequence. | retransmit the record. | 

| 

| 

| 

| 

| 

| 

=| 


O4dddd00 | Received timecut while reading data. | SML is requested to 
| | retransmit the record. 


eee ere eee eee nee Eee 


{| condition. | retransmit the record. 
6dddd00 | Lata overrun error. Program unable to read | SML is requested to 
| data before next character is received from | retransmit the record. 


| transmission line. | 


eee eee ee 


Data set not ready. Discovered at interrupt HASP/RTP1130 waits for data 


re 
| 
| —— 
| 
| 
| 
| 
| 
[= 
| 
| 
| 
! 
| 
! 
! 
| -_-—-_------+----___----—- 
|] OSddddo0O | BCC compare error after normal read complete | SML is requested to 
| 06 
| 
| 
= 
| 
| 
| 
| 
| 
| 
| 
| 
= 
| 0 
| 
| 
| 
| 


| 

O7dddd0oo | | | 

| time. | set to kecome ready and | 

| | then resumes operation on | 

| | the line. { 

ee Se RE ane a ee oar | 
O8dddd00 | Error on initial read. First character not | SML is requested to { 

| SOH, DLE, ENC, or NAK ...0r... SOH-STX, |] retransmit the record. | 

| DLE-STX, DLE-ACKO pair not found. | | 
ge aga SRP | 

d00Q | NAK received. | Last data recorded is | 

| | retransmitted to SMI. | 

a Be eee ee ee ee es 
OBdddd00 | Single DLE found in transparent data. | SML is requested to [ 

| | retransmit the record. | 

Se ee ee Se ee eS eee ee ee | 

| OCcdddd0O | ENQ received after initial sign-on sequence. | SML is requested to | 
| | [| retransmit the record. | 
| —-—---—-——--------- =~ —____ - —  - --—-| 
| Oddddroo | No pad character following NAK. | SML is requested to | 
| | | retransmit the record. | 
| ~-------_—------- ——__---___-__-. —_-------_-- | 
| Note: dddd = device status word received for the Synchronous Communication Adapter | 
| eerreeees i Sin a a i a So in ca Se Soe ere as me a a ee. en oe ———— —__. J 


Figure 14. HASP/RTP1130 Communication Adapter Error Messages 


Unit Record Errors 


Many of the unit record device errors that can occur during processing 
allow HASP/RTP1130 to continue processing without operator intervention. 
Seme errors, such as DATA check and END OF FORM, require operator 
assistance before use of the device can be continued. In any event, all 
errors occurring on unit record devices are logged in the VNET 
Environmental Recording Error Printout Table and are displayed 
immediately on the 1052 oferator's console. 
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When the error message is printed the operator should perform the 
following: 


1. Determine which device is in error (see Figure 15). 


2e Note the device status; if HASP/RTP360 continues to use the device, 
the error message is informative in nature. 


3. Correct the error in accordance with procedures prescribed for the 
device. 


4. Ready the device to resume operation. 


a Bt ie Oa nh a ha eg ah oe em sae oS) —— 
Message | Cescription | Program Action 
O5ssQaaa [| Unit check. LCevice with address "aaa" has | 

| unit check error descriked Ey sense byte "ss"| 

| and/or indicator lights on the device | 

| console. [ 

| | 

| Sample sense Lyte settings: | 

| | 

| 40 = Intervention required | Wait for operator. 

| 10 = Equipment check {| Treat as data check. 

| 08 = Data check — card read, card | Depending on device: 

| punched, or line printed | ignore, retry, or wait for 

| incorrectly. | operator. 

| 01 = {| Ignore. 

| | 


Carriage contrel tape channel 9 
encountered on printer : 


| Unusual end. Previous I/O came to an unusual | 
| end. IBM customer engineer should be | 
| consulted. | 
| cc = CSW byte 5 | 
| aaa = device address | 


ote: Printing on a line that has a carriage contrcel tape channel 9 or 12 punch 
appears aS an error and is logged as an error. The installation should place 
these punches in line rfesitions that do not contain print information. Do not 
eliminate the punches frem the carriage tape. 


Figure 15. HASE/RTP1130 Unit Record Error Messages 


REMOTE STATION RESTART 


In the event of an untimely interruption of the remote station operation 
(such as a machine, program, communications, or environmental failure), 
tke remote station operator should notify appropriate maintenance 
personnel of the malfunction. He should also save material that may ke 
of use in determining the source of the failure and, with the aid of the 
VNET operator, should prepare for restarting the station, as follows: 


1. Notify the VNET operator of the failure and, if necessary, request 
his assistance in preparing for restart. 
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| 
(ee 
| 
| 
| 
| 
| 
| 
[aa 
| 
| 
| 
| 
| 
| 
| 


2. Determine the current deck keing transmitted to VNET. (The VNET 
operator has a record of the current deck being submitted to VNET.) 
The input stream, starting with that current deck, must be 
submitted to VNET after restart. 


3. Determine the loss of data on the output devices, and inform the 
central operator to kackspace or restart the printer or punch, as 
necessary. (The VNET link should be made available for a subsequent 
sesSion with the remote station or other stations within the 
syster.) 


4. When the remote station is available, restart the session beginning 
with the Initial Prcegram Load of HASP/RTP1130. 


Load Process Unusual Conditions 


The first sight cards of the 1130 remote station deck comprise a 
kootstrap loader (RTPBROOT), that loads the main loader (RTPLOAL) into 
upper 1130 storage. RTPLOAL then loads the main station deck 
(HASP/RTP1130), processes REP cards (if any), and processes the /*SIGNON 
card (if included). 


Figures 16 and 17 descrike the unusual conditions that may occur in 
conjunction with RTPEROOT and RTPIOAL. 


LOCAT MESSAGE SUMMARY 


Messages that are printed cn the console typewriter originate from the 
VNET system or are generated ky HASP/RTP1130, in conjunction with the 
Station operation. Messages from VNET may be identified by the 
three-character 'DMT' prefix and by the fact that they are printed in 
red if the red/klack typewriter ribbon is installed. 


ITocal messages (typed in ktlack) are listed in Figure 18 along with a 
detailed explanation of each message. 


EE ES SS ST cD A ce a I A “A oe SE a ce ES Ce Se eo ce SD ae 


Seer ioe S 
Condition Indication | Condition Description | Operator Action | 
sae ty See ANI eS SU Oe ee NEN re ed We ee cae a ee a Ns ecto] 

System loop at location | RTPROOT-computed sum Loading of RTPLOAP is | 
'AA' with IAR displayed at|{ (checksum) of colunns 1~72 permanently terminated, Note] 


| match value in columns contact system prodqrammer or; 
{ 73—74, previously computed lead operator about probijen. 
{ during RTPLOAD generation. | 


location ‘AR, | of last card read does not | card being processed, and 


ee ren ee | 


¢ 


System loop at location | RTPRCOT detected illegal | Loading of RTPLCAF is 


ae ie a te ee rn ee ee ee ee ee ee 


re ee ee ee 


"AE* with TAP displaying | FECEIC punch in RTPLOAL card| permanently terminated. Not | 

location ‘AF*. AC contains| just read, or the last four | card keing processed, ard H 

card code value of colunrn | cards of RTPEOOT contain an | contact system proqramm:r ar! 

in errcr. XR2 contains 2s {| illeqal ERCLIC punch. | lead operator aboot prohler, 
| | 


t 


corplement of card cclurn 
it, AYrrer. | | 


cs rr ee et we cm ee mn ee a. — ce ee ee fora i ee i —_ ae ai ee = 
—————— ee rte an ee — — een a ee Pr 


2 


Figure 16. HASP/RTP1130 Loading Errors (RTPBOOT) 
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operator. 


kFTPLOALC—computed sum 
(checksum) of columns 1—72 
of last HASP/RTP1130 card 


| Loading may ke resumed 
| 

| read does not match value in 

| 

| 

| 


pressing start on 1130 
console. Unpredictakle 


System wait at location 
'0010'. AC displays value 
"YER Z*s 

columns 73-74, previously action is to note card 
computed. 


coe Se ee ee 


This is not an error. The 
last card has keen read by 
the 2501 or 1442, and 
operator action is 
required. 


System wait at location 
"0010". AC displays value 
TEER IT 3 


| 


console. 


eC —_— n  ae  e  e 4 


Figure 17. HASP/RTP1130 Loading Frrors (RTPLOAD) 


VNET AS A REMOTE JOB ENTRY STATION 


The VNET virtual machine, through the use of an SML line driver 
operating in RJE mode, can perform the functions of a MULTI-LEAVING 
workstation. In this capacity, VNET accepts job files that are either 
spooled to it by VM/370 virtual machines or received from VNET supported 
remote stations. It then transmits the job files, via the SML line 
driver, to the remote katch system for processing. Output, received 
from the remote system is directed to the real printer or punch of the 
directly ccnnected VM/370 system. 


Configuration Specifications 


Any of the System/370 Models 135, 135-3, 138, 145, 145-3, 148, 155 II, 
158, 165 II, and 168, with at least 240K of processor storage, a minimum 
of two direct access storage devices, and equipped with a transmission 
control unit supported by VNET, can ke used as a remote job entry 
station to access a remote t-atch processor. The supported transmission 
control units are: 


e Integrated Communications Adapter (ICA) with Synchronous Data Adapter 
Type II on the System/370 Model 135 


e IEM 2701 Data Adapter Unit with Synchronous Data Adapter Type II 
e IBM 2703 Transmission Control Unit with Synchronous Terminal Control 
e IBM 3704 Communications Controller in emulaticn mode only 


e IBM 3705 Communications Controller in emulation mode only 
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results may occur. Rest 


| 

| 

| 

| 

| error and notify system 
| programmer cr lead operator. 
| 

| 

| 

| 

| 


To commence HASE/RTEP1130 
processing, press START on 

the card reader until ready; 
then press START on the 1130 


kon eer aay aaaa cer eis Sea SS corer | 
Condition Indication | Condition Description | Operator Action 
System wait at location | The last REP card read Loading is terminated 
'0010'. AC displays value contained a format error. permanently. Note that a 
'FFE3* card is in error, and notify 


system programmer or lead 


in 


| 
| 
| 
| 
| 
| 
| 
| 
by | 
| 
| 
| 
| 
| 
| 
| 
| 


—_—__I 


J 


we 


Cc 


( ee ee Se eS EE ee) ee eg es es ee, ee ee ee a ee ee es ee + 


INTERVENTION REQUIRED ON | Where xxxx is 1442, 2501, 1403, or 1132. This message | 
XXXX indicates that the indicated device has gone from a ready | 
to a "not ready" condition, usually hecause the device was| 
| manually stopped or because the device requires operator | 
| action (for example, cards or paper). The device should be| 
| serviced as required and made ready tec continue operation. | 
PUNCH PROCESSOR WAITING | This message is issued whenever punch data is waiting to 
FOR 1442 | ke punched on a system equipped with a combination 1442 
| Card Read Punch. If the 1442 is defined as a reader, it 
| must complete the read function before it can be defined 
| as a punch. If the 1442 is defined as a funch, no further 
| action (other than providing blank cards and making the 
| device ready) is necessary. 
CATA SET NOT READY | This wessage is issued when the communications adapter 
| signals HASP/RTP1130 that the attached telephone data set 
{ is in a "not ready" cordition. The program does not 
| attempt to use the communication adapter until a "ready" 
| condition is detected. All other functions (card input, 
| typewriter, etc.) continue until they require the service 
| of the data set. If the data set was made "not ready" 
| by manual intervention, operation may be resumed by 
| making it ready. 
| 
| 
| 
| 
| 


CAUTION: The VNET machine may print error messages that 
could cause the operator to restart the communications 
line. In this event, the HASP/RTP1130 program must be 
reloaded. 
SCA LOG xxxxxx00 | Indicates an unusual condition associated with the SCA 
{ (Synchronous Communication Adapter). 


COMMUNICATION LINE | Issued when the HASP/RTP1130 program is initialized and | 
ESTABLISHED { when communications have been established with the VNET | 
| machine. | 


WHAT? | Response to any local command not recognized or accepted | 
| by HASP/RTP1130. 


OK! | Response to any local command recognized or accepted by | 
| HASP/RTP1130. 


Figure 18. IBM 1130 Local Messages 


SML AS THE REMOTE TERMINAL PROCESSOR (RTF) PROGRAM 


In order for a system or device to function as a MULTI-LEAVING 
workstation, a Remote Terminal Processor (RTP) program must be loaded to 
provide the software functions of input, output, and communication 
according to the protocol estaklished by the host batch processor. An 
SMI line driver task, operating in RJE mode, provides these functions 
for VNET when it is to act as a workstation for a remote batch system. 
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Input Functions 


The SML line driver, operating in RJE mode, provides the following input 
functions at the VNET virtual machine: 


e Accesses jok files received by VNET from VM/370 virtual machines or 
remote stations (either WORKSTATIONS or remote NJI/NJE systems). 

e Accepts batch system commands entered at the VNET operator console. 

e cCompresses and blocks card images and commands into transmission 
records according to the frotocol requirements of the receiving Latch 


system. 


e Transmits the blocked records to the remote batch system. 


Output Functions 
The SML line driver, operating in RJE mode, provides the following 
output functions at the VNET virtual machine: 


e Deblocks and decompregses transmission records received from the 
remote system. 


e Identifies the device required for output. 
e Spools the output to the real printer and/or punch. 


e Directs messages from the remote katch system to the VNET operator's 
console. 


Operating Procedures 


With the exception of the initialization and sign-cn procedure, the 
operation of VNET as a MULTI-LEAVING workstation is Similar to that 
described under the section "IBM System/370 as a Remote Station." 


Starting the SMI Line Criver 


Once the VNET virtual machine is logged on and the VNET component is 
loaded, the VNET operator can start the SMI line driver. 


Issue the START command for the link to the remote batch system. 


If the link attributes in the link takle are appropriate for this 
session, the START command can be issued as follows: 


c q 

|Hrn | 

START linkid Parm |Rrn| Ennnn passwd 
{Arn| 
Lt J 
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A description of the START command operands, including those that 
override previous definiticns, can be found in the section "Starting 
SSL" in “Part 3: VNET System Operation". 


The Hrn, Rrn, and Arn operands specify the type of remote batch system 
(HASP, RES, or ASP) and the workstation number or name that was assigned 
to VNET at the time the remote system was generated. 


For HASP (or JES2), rm is a number from 1 through 99 and the entry could 
look like: H3, H20, or H43. 


For RES, rn is also a numker from 1 through 99 and the entry could look 
like: R2, R50, or R77. 


For ASP (or JES3), rn is a five alphamreric character name and the entry 
could look like: ANEFWYK, AFURL5, APOK16, or A62121. 


The successful execution of the START command results in the following 
message: 


DMTSML141I LINE 'vaddr' READY FOR CONNECTION TO LINK ‘linkid' 
Establishing A Communication Line 


If the line identified by vaddr in the previous message is a nonswitched 
line, the line connection is automatically completed and the following 
message is issued: 


CMTSML142T LINK *linkid! LINE 'vaddr' CONNECTED 


If the line is a switched line, the VNET operator should perform the 
following: 


1. Press the TALK button, and lift the receiver off the data set. 
22194800 


3. If the line is availaktle, the remote system answers with a high 
pitched tone. Press DATA and hang up immediately; the data set is 
now ready and the DMTSML142T message is issued. 


4 If the line is in use, a busy signal is heard. Hang up and try 
later, or dial an alternate communication line number. 


5. If the call is not answered, the remote system operator has not 
given the necessary ccmmand to authorize use of that communication 
line. Contact the remote system operator and request that he issue 
the appropriate START command for your workstation. 


When requested by the remote system, the SML line driver begins the 
initial control sequence. When the initial sequence is complete, the 
sign-on procedure is performed. 


Signing On to The Remote System 


The SML line driver builds a SIGNON record from the information 
centained in the VNET START command. This record is then transmitted to 
the remote system for validation. When accepted, the SML line driver 
"handshakes" with the remote system until processing of job streams and 
output data actually begins. 


Appendix C: Remote Terminals and Stations 243 


244 VNET Reference and Operations 


A 


ACCEPTED BY TASK: See Message. 
accepting file at destination node 
12 

accounting information 36 
accounting records provision 10 

ACTIVATING LINK: See Message. 

ACTIVE FILE SENDING RESUMED ON 
LINK: See Message. 

active files: See Files, Active 

adding links 95 

alternate path facility 9 

automatic routing 3 


E 


EACKSPAC Command: See Command, 
BACKSPAC. 


c 


card formats: See ID Card Format 
and Reader Card Format. 
CHANGE command: See Command, 
CHANGE. 
changing the routing table: See 
Command, Route. 
CLOSE command: See Command, CLOSE. 
CMD command: See Command, CMD. 
command, 
BACKSPAC 52,92 
CHANGE 51,92 
CLOSE 52,93 
CMD 52,94 
CP 53,95 
comment: See Command, * 
DEFINE 49,95 
DELETE 50,97 
DISCONN 53,97 
CRAIN 50,98 
EXEC 53,98 
FLUSH 52,99 
FORCE 50,100 
FREE 50,100 
FWDSPACE 52,101 
HOLD 50,101 
HT 53,102 
MSG 53,103 
ORDER 51,103 
PURGE 51,104 
QUERY 53,104 
REORDER 51,108 
ROUTE 50,108 
SHUTDOWN 51,109 
SPOOL 75,78 
START 50,109 
TAG 75,78 
TRACE 55,111 
TRANSFER 51,112 
* (Comment) D3 9:1 
command responses: See Responses, 
Command. 


INDEX 


command usage, operator 91 
commands, 
communication 52 
file control 51 
link and line control 49 
miscellaneous 53 
NJE global: See NJE Global 
Commands. 
operator 3,49 
remote station operator 63 
remote terminal operator 66 
stored: See Stored Commands. 
user 75 
VNET 89,91 
commands to VM/37/70: See Command, CP. 
comment command: See Command, 
* (Comment) . 
common factors, VME/VMC/NJI: See 
VME/VMC/SNJI Common Factors. 
communicating with JES2 NJE 
Systems: See JES2 NJE, 
Communicating with. 
communication commands: See 
Commands, Communication. 
compatikle nodes’ 13 
components of a VNET system 15 
CONFLICTING KEYWORD: See Message. 
CONFLICTING OPTION: See Message. 
control statement, 


LINK 29 
LOCAL 29 
PARM 30 
PORT 32 
ROUTE 31 
TAGS 32 


control statements 28 

control tasks: See System Control 
Tasks. 

CP command: See Command, CP. 

CP SPOOL: See Command, SPOOL. 

CP TAG command: See Command, TAG. 

CYLINDER IN USE FOR CMS FILES: 
see MesSage. 


D 


deactivating a link 98 

DEFINE command: See Command, DEFINE. 
defining VNET virtual machine 40 
DELETE command: See Command, DELETE. 
deleting a file: See Command, PURGE. 

deleting links 97 

DEV IS NOT A LINE PORT--LINK NOT 
ACTIVATED: See Message. 

directory: See Dynamic Directory. 
directory control statements: See 
Control Statements. 

directory examples 33 

DISCONN command: See Command, 
DISCONN. 

disconnected mode operation 9 
disconnected operation 55,97 
disconnecting operation console 7 
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See also Command DISCONN. 

CRAIN command: See Command, DRAIN. 
DRIVER FILE FORMAT INVALID--LINK 
NOT ACTIVATED: See Message. 
CRIVER NOT FOUND ON DISK--LINK NOT 
ACTIVATED: See Message. 
drivers: See Line Drivers. 
TUPLICATE LINK ID: See Message. 
DUPLICATE LOCATION ID: See Message. 
CIRECTORY ENTRY OUT OF ORDER: 

See Message. 
DUPLICATE PORT ADDRESS: See Message 
dynamic directory, VNET 27 
dynamic reconfiguration 70 


E 


€xamples, user 81 
EXEC commands See Command, EXEC. 
EXEC facility 9 
EXEC FILE FORMAT INVALID--EXEC 
NOT EXECUTED: See Message. 
EXEC IN EXECUTION--NEW EXEC COMMAND 
IGNORED: See Message. 
EXEC NOT FOUND ON DISK--COMMAND 
FILE NOT EXECUTED: See Message. 
EXECUTING COMMAND: See Message. 


F 


FATAL ERROR LOADING DMTAXS: See 
Message. 
FATAL ERROR LOADING 
Message. 
FATAL ERROR LOADING 
NOT ACTIVATED: See Message. 
FATAL ERROR READING FROM..-e--EXEC 
PROCESSING TERMINATED: See 
Message. 
FATAL ERROR READING VNET 
see Message. 
FILE: See Message. 
file 
accepting at destination node: 
See Accepting File at 
Destination Node. 
passing to end user: See Passing 
File to End User. 
sending to next node: See 
Sending File to Next Node. 
ACTIVE ON LINK: See Message. 
ACTIVE--NO ACTION TAKEN: 
Message. 
BACKSPACED: See Message. 
CHANGED: See Message. 
control commands: See 
File Control. 
ENQUEUED ON LINK: See Message. 
FORWARD SPACED: See Message. 
HELD FOR LINK: See MesSage. 
INACTIVE--NO ACTION TAKEN: 
Message. 
INACTIVE ON LINK: See Message. 
IS FOR LINK--NO ACTION TAKEN: 
Message. 


DMTLAX: See 


FROM... e~~LINK 


DIRECT: 


FILE 
FILE 

See 
FILE 
FILE 
file 

Commands, 
FILE 
FILE 
FILE 
FILE 

see 
FILE 
FILE 

See 
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FILE 

see 
FILE 
FILE 


MISSING--DEQUEUED FROM LINK: 
Message. 
NOT ACTIVE: See Message. 
NOT FOUND: See Message. 
FILE NOT FOUND--NO ACTION TAKEN: 
See Message. 
FILE..-ORG.--ORGID: See Message. 
FILE PENDING FOR LINK: See Message. 
FILE...PR..-ClLe.-C0..- DI - NAwee : 
See Message. 
file processing, 
HOST mode: See Input File 
Processing (HOST Mode). See 
also Output File Processing 
(HOST Mode). 
input: See Input File Processing. 
Output: See Output File 
Processing 
RJE mode 62 Ne 
FILE PROCESSING TERMINATED: See 
Message. 
FILE PURGED: See Message. 
FILE QUEUE REORDEREC: See Message. 
file receiving from source: See & 
Receiving File From Source. 
FILE REJECTED--INVALID DESTINATION 
ADDRESS: See MesSage. 
FILE RELEASED FOR LINK: See Message. 
FILE SPOOLED TO: See Message. 
file status information 54 
see also Command, Query. 
file store and forward: 12 
file transfer: See Transferring a 
File. 
file transmission, 


deleting a file: See Command, w 
PURGE. 
"Hung"" Files 133 
See also Command, REORDER. 
moving files 141 
See also Command, TRANSFER. 
reorganizing the queue, 
See Command, ORDER. 
resuming: See Resuming File 
Transmission. 
sample: See Sample File 
Transmission. 
Stopping: See Stopping File 
Transmission. 
suspension: See Command, HOLD. 
FILE(S) CLOSED ON LINK: See Message. ” 
FILE(S) PURGED ON LINK: See Message. 
FILE(S) TRANSFERRED ON LINK: See 
Message. 
files, » 


active 51 

inactive 51 

Managing returned: See Returned 

Files, Managing. 

pending 27 

rejected: See Rejected Files. 
FLUSH command: See Command, FLUSH 
FORCE command: See Command, FORCE 
FREE command: See Command, FREE 
FREE STORAGE = ‘'nnt PAGES: See 


Message. 
FROM...: See Message. 
functions supported, 
VMB/VMC/NJI common factors 23 
SML: See SML Supported Functions 
FWDSPACE command: See Command, 
FWOSPACE. 


G 
generation procedure for VNET 41 
H 


halting file transmission: See 
Stopping File Transmission. 
hardware products supported by 
NPT. 
See NPT-Supported Hardware 
Products. 
hardware products supported by SML: 
See SML-Supported Hardware. 
HASP MULTI-LEAVING remote station 
199 
HOLD commands: 
HOST mode, 
input file processing: See 
Input File Processing (HOST 
Mode) 


See Command, HOLD. 


output file processing: See 
Output File Processing (HOST 
Mode). 
Signing on: See Signing On In 
HOST Mode. 
HT command: See Command, HT. 


I 


IBM System/3 as a remote station 
217 

IBM System/3 model 10 card system 
aS a remote system 219 

IBM System/32 as a remote station 
217 

IBM System/360 aS a remote station 
199 

IEM System/360 model 20 as a remote 
station 207 

IEM System/370 as a remote station 
199 


IEM 1130 System as a remote station 
231 

IBM 2770 181 

IEM 2780 185 

IBM 2922 as a remote station 207 
IEM 3770 190 

IBM 3780 193 


IC card format from remote stations 
56 

ID CARD MISSING ON LINK--INPUT FILE 
PURGED: See Message. 

immediate link deactivation 100 

inactive files: See Files, Inactive 

INCORRECT PASSWORD RECEIVED ON 
LINK: See Message. 


INDIRECT ROUTING FOR...DEACTIVATED: 
See Message. 

INITIALIZATION FAILURE--VNET 
SHUTDOWN: See Message. 

input file processing 65 

input file processing (HOST mode) 


62 
input/output control, 
NPT 22 
SML 19 


installation of VNET 8,25,27 

installation considerations 37 

installation requirements 37 

installing VNET 39 

INVALID CLASS SPECIFICATION: 
Message. 

INVALID COMMAND: See Message. 

INVALID CYLINDER NUMEER - REENTER: 
See Message. 

INVALID DEVICE ADLRESS - REENTER: 
See Message. 

INVALID DIRECTORY ENTRY: 
Message. 

INVALID DRIVER SPECIFICATION: 
Message. 

INVALID KEEP SPECIFICATION: 
Message. 

INVALID KEYWORD: See Message. 

INVALID LINK: See Message. 

INVALID LOCATION: See Message. 

INVALID NJI EUFFER SIZE SPECIFIED-- 
LINK NOT ACTIVATED: See Message. 

INCOMPATIBLE NJI EUFFER SIZES--LINK 
IS BEEING DEACTIVATED: See Message. 

INVALID NJI NODAL RESISTANCE 
SPECIFIED--LINK NOT ACTIVATED: See 
Message. 

INVALID NJI PARAMETER ON TAG-- 
PARAMETER IGNOREC: See Message. 

INVALID NJI SIGNON CONNECTION 

RECORD RECEIVED--LINK IS BEING 
DEACTIVATED: See Message. 

INVALID OPTION: See MeSsage. 

INVALID PASSWORD PARAMETER SPECIFIED 
--LINK NOT ACTIVATED: See Message. 


see 


see 


see 


see 


INVALID REPLY - ANSWER "YES" OR 
"NO"3 See Message. 
INVALID ROUTE SPECIFIED: See 


Message. 
INVALID SML BUFFER PARAMETER--LINK 
NOT ACTIVATED: See Message. 
INVALID SML MODE SPECIFIED--LINK 
NOT ACTIVATED: See Message. 
INVALID SPOOL BLOCK FORMAT ON FILE: 
see Message. 
INVALID SPOOL ID: See Message. 
INVALID TASK SPECIFICATION: 
see Message. 
INVALID USER ID: See Message. 
INVALID ZONE SPECIFICATION: 
see Message. 
I/O ERROR message: 
I/O ERROR. 
IPL DEVICE ERROR - REENTER:? 
Message. 


see Message, 


see 
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IPL DEVICE READ I/O ERROR: See 
Message. 
IPL DEVICE WRITE I/O ERROR: 
See Message. 
issuing remote system commands: 
See Command, CMD. 
issuing VM/370 commands: 
Command CP. 


see 


J 
JES2 NJE, communicating with 56 
L 


line activity information: See 
Command, TRACE 
line allocation, 
UPT 22 
SML 19 
LINE CC=3 NOT OPERATIONAL~-LINK NOT 
ACTIVATED: See Message. 
line control commands: See Commands 
LINE DISABLED FOR LINK: See Message 
line driver, 
NJI: See NJI Line Driver. 
NPT: See NPT Line Driver. 
restarting: See Restarting a 
Line Driver. 
Starting: See Starting Line 
Drivers. 
VME: See VMB Line Driver. 
vMC: See VMC Line Driver. 
line driver selection 36 
line drivers 16 
LINE IS IN USE BY LINK--LINK 
ACTIVATED: See Message. 
LINE READY FOR CONNECTION TO 
See Message. 
link, definition of 13 
LINK: See Message. 
LINK ACTIVE--NO FILE(S) CLOSED: 
see Message. 
LINK ACTIVE--NOT DELETED: See 
Message. 
LINK ACTIVE--NOT REDEFINED: 
Message. 
LINK ALREADY ACTIVE--NEW CLASS(S) 
SET AS REQUESTED: See Message. 
LINK ALREADY ACTIVE--NO ACTION 


NOT 


LINK: 


see 


TAKEN: See Message. 
LINK ALREADY IN HOLD STATUS: 

See Message. 

LINK ALREADY SET TO DEACTIVATE: 

see Message. 

link attributes 13 

link control commands: See Commands 
LINK control statement: See 


Control Statement, LINK. 

LINK DEACTIVATED: See Message. 

link deactivation: See Deactivating 
a Link. 

link deactivation, immediate: 
Immediate Link Deactivation. 

LINK DOES NOT MATCH REMOTE LOCATION 


see 
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see 
LINK 
LINK 


Message. 
EXECUTING: See Message. 
FILE TRANSMISSION SUSPENDED: 


See Message. 

LINK HAS A FILE QUEUE--NOT DELETED: 
See Message. 

LINK ID MISSING OR INVALID: See 
Message. 


LINK IN RJE MODE--PRINT 
PURGED: See Message. 
LINK INACTIVE: See Message. 
LINK INACTIVE--DEFAULT: See Message. 
LINK INACTIVE--DEFAULT LINE: 
See Message. 
LINK IS NOT ACTIVE: 


FILE 


See Message. 


LINK IS NOT DEFINED: See MeSSage. 

LINK LINE ACTIVITY: TOT=: See 
Message. 

LINK LINE DATASET READY: See \ 
Message. 

LINK LINE DISCONNECTED: See 
MesSage. 


LINK LOG ACTIVATED: See Message. 
LINK LOG ALREADY ACTIVE: See | 
Message. 
LINK LOG DEACTIVATED: See Message. 
LINK LCG NOT ACTIVE: See Message. 
LINK NOT CONNECTED: See Message. 
LINK NOT DEFINED--LINK LIMIT 
REACHED: See Message. 
LINK NOT IN HOLD STATUS: 
Message. 
LINK NOT DELETED: See Message. 
LINK NOW SET TO DEACTIVATE: 
see Message. 
LINK QUEUE REORDERED: See MeSsage. 
LINK REDEFINED: See Message. 
LINK RESUMING FILE TRANSFER: 
Message. 
LINK STILL ACTIVE--DRAIN 
RESET: See Message. 
link status information 
link status information: 
Command, QUERY. 
link takle 27 
LINK SUM REPORTING ALREADY ACTIVE: 
see Message. 
LINK SUM REPORTING DEACTIVATED: 
See Message. 
LINK SUM REPORTING NOT ACTIVE: 
See Message. 5 
link takle, changing 71 
LINK TO SUSPEND FILE TRANSMISSION: 
see Message. 
LOCATION ID MISSING OR INVALID: r) 
See Message. 
LOCATION EXECUTING: See Message. 
LOCATION HAS A FILE QUEUE--INDIRECT 


see 


see 
STATUS 


53,54 
see 


ROUTING NOT DEACTIVATED: See 
Message. 

LOCATION IS NOT DEFINED: See 
Message. 


local control statement: See Control 
Statement, LOCAL. 


LOCAL LOCATION DEFINITION MISSING: 


see Message. 
LOCAL PREVIOUSLY SPECIFIED: 
See Message. 

local system definition 27 


M 


Maintenance 44 
MAX ACTIVE--LINK NOT ACTIVATED: 
see Message. 
MAX TAGS REQUEST OF 1 PER VIRTUAL 
STORAGE K ASSUMED: See Message. 
message 
ACCEPTED BY TASK 160 
ACTIVATING LINK 136 
ACTIVE FILE SENDING RESUMED 
ON LINK 158 
CONFLICTING KEYWORD 123 
CONFLICTING OPTION 123 
CYLINDER IN USE FOR CMS FILES 
142 
CEV IS NOT A LINE PORT--LINK 
NOT ACTIVATED 137 
CIRECTORY ENTRY OUT OF ORDER 


DRIVER FILE FORMAT INVALID--LINK 


NOT ACTIVATED 138 
DRIVER NOT FOUND ON DISK--LINK 
NOT ACTIVATED 137 
DUPLICATE LINK IC 146 
CUPLICATE LOCATION ID 145 
DUPLICATE PORT ACDRESS' 146 
EXEC FILE FORMAT INVALID~-- EXEC 
NOT EXECUTED 135 
EXEC IN EXECUTION--NEW EXEC 
COMMAND IGNORED 136 


EXEC NOT FOUND ON DISK--COMMAND 


FILE NOT EXECUTED 135 
EXECUTING COMMAND 154 


FATAL ERROR LOADING CMTAXS 149 
FATAL ERROR LOADING CMTLAX 150 


FATAL ERROR LOADING FROM...-- 
IINK NOT ACTIVATED 138 
FATAL ERROR READING FROM...-- 


EXEC PROCESSING TERMINATED 135 
FATAL ERROR READING VNET DIRECT 


149 
FILE 131 
FILE ACTIVE ON LINK 132 
FILE ACTIVE--NO ACTION TAKEN 
FILE BACKSPACED 162 
FILE CHANGED 118 
FILE ENQUEUED ON LINK 115 
FILE FORWARD SPACED 164 
FILE HELD FOR LINK 119 
FILE INACTIVE ON LINK 132 
FILE INACTIVE--NO ACTION TAKEN 


118 

FILE IS FOR LINKX--NO ACTION 
TAKEN 120 

FILE MISSING--DEQUEUED FROM 
LINK 117 


FILE NOT ACTIVE 163 
FILE NOT FOUND 133 


FILE NOT FOUND--NO ACTION TAKEN 


120 


FILE...ORG...ORGID 132 

FILE PENDING FOR LINK 116 

FILE..-PRe.e-CLle--CO.--DI--- NA 
13.2 

FILE PROCESSING TERMINATED 163 
FILE PURGED 117 

FILE QUEUE REORCERED 117 

FILE REJECTED--INVALID 
DESTINATION ADCRESS' 116 

FILE RELEASED FOR LINK 119 

FILE SPOOLED TO 116 

FILE(S) CLOSED ON LINK 118 

FILE(S) PURGED ON LINK 120 

FILE(S) TRANSFERRED ON LINK 120 

FREE STORAGE="nnt PAGES 120 

FROMee. 160 

ID CARD MISSING ON LINK--INPUT 
FILE PURGED 169 

INCOMPATIELE NJI BUFFER SIZES 
--LINK IS BEING DEACTIVATED 151 
INCORRECT PASSWORD RECEIVED ON 
LINK 168 

INDIRECT ROUTINE FOR... 
DEACTIVATED 127 
INITIALIZATION FAILURE--VNET 
SHUTDOWN 154 

INVALID CLASS SPECIFICATION 148 

INVALID COMMAND 122 

INVALID CYLINDER NUMBER - 
REENTER 142 

INVALID DEVICE ADDRESS - REENTER 
142 

INVALID DIRECTORY ENTRY 144 

INVALID DRIVER SPECIFICATION 147 

INVALID KEEP SPECIFICATION 148 

INVALID KEYWORD 122 

INVALID LINK 122 

INVALID LOCATION 124 

INVALID NJI BUFFER SIZE SPECIFIED 
--LINK NOT ACTIVATED 152 

INVALID NJI NOLVAL RESISTANCE 
SPECIFIED--LINK NOT ACTIVATED 
152 

INVALID NJI PARAMETER ON TAG-- 
PARAMETER IGNORED 151 

INVALID NJI SIGNON CONNECTION 
RECORD RECEIVED--LINK IS BEING 
DEACTIVATED 151 

INVALID OPTION 123 

INVALID PASSWORD PARAMETER 
SPECIFIED--LINK NOT ACTIVATED 
168 

INVALID REPLY - ANSWER "YES" OR 
mo" 142 

INVALID ROUTE SPECIFIED 128 

INVALID SML BUFFER PARAMETER-- 
LINK NOT ACTIVATED 155 

INVALID SML MODE SPECIFIED-- 
LINK NOT ACTIVATED 155 
INVALID SPOOL BLOCK FORMAT 

ON FILE 160 

INVALID SPOOL ID. 122 

INVALID TASK SPECIFICATION 148 
INVALID USER ID 123 

INVALID ZONE SPECIFICATION 147 
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I/O ERROR 155 

IPL DEVICE ERROR - REENTER 142 

IPL DEVICE READ I/O ERROR 143 
IPL DEVICE WRITE I/O ERROR 143 

LINE CC=3 NOT OPERATIONAL--LINK 
NOT ACTIVATED 137 

LINK DISABLED FOR LINK 159 

LINE IS IN USE BY LINK--LINK 
NOT ACTIVATED 136 

LINE READY FOR CONNECTION TO 
LINK 156 

LINK 129, 133 

LINK ACTIVE--NO FILE(S) CLOSED 
118 

LINK ACTIVE--NOT DELETED 126 

LINK ACTIVE--NOT REDEFINED 125 

LINK ALREADY ACTIVE--NEW 

CLASS (ES) SET AS REQUESTED 139 

LINK ALREADY ACTIVE--NO ACTION 
TAKEN 139 

LINK ALREADY IN HOLD STATUS 165 

LINK ALREADY SET TO DEACTIVATE 
163 

LINK DEACTIVATED 153 

LINK DOES NOT MATCH REMOTE 
LOCATION 168 

LINK EXECUTING 121 

LINK FILE TRANSMISSION 
SUSPENDED 164 

LINK HAS A FILE QUEUE--NOT 
DELETED 126 

LINK INACTIVE 129 

LINK INACTIVE--LDEFAULT 134 

LINK INACTIVE--DEFAULT LINE 134 

LINK ID MISSING OR INVALID 147 

LINK IN RJE MODE--PRINT FILE 
PURGED 155 

LINK IS NOT ACTIVE 161 

LINK IS NOT DEFINED 161 

LINK LINE ACTIVITY: TOT= 159 

LINK LINE DATASET READY 157 

LINK LINE DISCONNECTEC 157 

LINK LOG ALREADY ACTIVE 166 

LINK LOG ACTIVATED 165 

LINK LOG DEACTIVATED 165 

LINK LOG NOT ACTIVE 166 

LINK NOT IN HOLD STATUS 164 

LINK NOT CONNECTED 162 

LINK NOT DEFINED--LINK LIMIT 
REACHED 125 

LINK NOW DELETED 125 

LINK NOW SET TO CEACTIVATE 163 

LINK QUEUE REORDERED 119 

LINK REDEFINED 125 

LINK SUM REPORTING NOT ACTIVE 


LINK RESUMING FILE TRANSFER 164 

LINK STILL ACTIVE--DRAIN STATUS 
RESET 139 

LINK SUM REPORTING ALREADY 
ACTIVE 166 

LINK SUM REPORTING DEACTIVATED 
166 

LINK TO SUSPEND FILE TRANSMISSIO 
164 
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LOCAL LOCATION DEFINITION 
MISSING 150 

LOCAL PREVIOUSLY SPECIFIED 145 

LOCATION EXECUTING 121 

LOCATION HAS A FILE QUEUE-- 
INDIRECT ROUTING NOT DEACTIVATED 
129 

LOCATION ID MISSING OR INVALID 
146 

LOCATION IS NOT DEFINED 124 

MAX ACTIVE--LINK NOT ACTIVATED 
139 

MAX TAGS REQUEST OF 1 PER 
VIRTUAL STORAGE K ASSUMED 144 

NEW LINK DEFINED 124 

NJI LINKe.e 151 

NO FILE ACTIVE 133 

NO FILE ACTIVE ON LINK 162 

NO FILES QUEUED 135 

NO LINK ACTIVE 134 

NO LINK DEFINED 134 

NO LOCATIONS ROUTED 128 

NO PORTS AVAILABLE 127 

NO REMOTE PUNCH AVAILABLE ON 
LINK--FILE PURGED 152 

NO SWITCHED LINE AVAILABLE-- 
LINK NOT ACTIVATED 136 

NON-SIGNON CARD READ ON LINK 167 

NOT LOGGED ON 154 

NOT RECEIVING 154 

NOT ROUTED 128 

NOT ROUTED-~-ROUTE LIMIT REACHED 
128 

NOW ROUTED THROUGH LINK 127 

NUCLEUS CYL ADDRESS= 141 

NUCLEUS WRITE COMPLETE 140 

PARM PREVIOUSLY SPECIFIED FOR 
IINK 145 

PASSWORD SUPPLIED ON LINK IS 
INVALID 167 

PENDING FILES FOR LINK MISSING 
117 

PORT ADDRESS MISSING OR INVALID 
147 

PORT AVAILABLE 127 

PORT IN USE BY LINK 127 

PROGRAM CHECK IN SUPERVISOR-- 
VNET SHUTDOWN 153 

PROGRAM CHECK--LINK DEACTIVATED 
153 

RECEIVED FILE... 157 

RECEIVING FILE... 157 

REJECTED BY TASK 160 

REJECTED BY TASK--NOT RECEIVING 
161 

RESTRICTED COMMAND 124 

REWRITE THE NUCLEUS? 140 

eeeROUTED THROUGH LINK 128 

SENDING FILE... 158 

SENT FILE... 158 

SIGNON OF LINK COMPLETE 167 

SIGNON PARAMETER= ON LINK 
INVALID 167 

SIGNON SEQUENCE ON LINK FAILED 
168 


SIGNON TYPE PARAMETER MISSING 
152 

SYSTEM DISK ADDRESS = 140 

SYSTEM ERROR REALING SPOOL FILE 


156 

TAGS COUNT MISSING OR INVALID 
148 

TAGS PREVIOUSLY SPECIFIED 145 


TASK NAME ALREADY IN USE--LINK 
NOT ACTIVATED 139 
UNDEFINED LINK ID 146 
UNSUPPORTED SYSTEM RESIDENCE OR 
DEVICE TYPE 149 
USER ID MISSING OR INVALID 154 
USER NOT IN CP DIRECTORY--FILE 
SPOOLED TO SYSTEM 118 
USER ID NOT RECEIVING 126 
VALID COMMAND RECOGNIZED ON 
LINK--NO ACTION TAKEN 162 
VIRTUAL STORAGE CAPACITY EXCEEDE 
--LINK NOT ACTIVATEC 138 
VNET 121 
VNET DIRECT 143 
VNET DISCONNECTING 
VNET READY 143 
message formats 55 
ressage summary 169 
messages, 55,115 
initialization 
NPT 67 
remote 
sign-on 
SML 63 
Spontaneous 
Suppression: 
user 83 
messages generated by more than one 
module 155 
miscellaneous commands: 
Commands, Miscellaneous 
modifying VNET directory 27 
moving files: See Command, TRANSFER 
MSG command: See Command, MSG. 
multi-node mesh connected network. 
See Network, Multi-Node Mesh 
Connected. 
MULTI-LEAVING' 16 


126 


178 


103 
177 


170 


See Command, HI. 


see 


N 


network, 
multi-node mesh connected 35 
three-node store and forward 34 
two-node 34 
network job interface: See NJI. 
network members: See NJI Network 
Members. 
network nodes 3 
network operations: 
Network Operation 
NEW LINK DEFINED: See Message. 
NJE global commands 56 
NJE protocol 56 
NJI, 
uses of 3 


see NJI 


Starting: See Starting NJI. 
characteristics 3 
configuration 5 
line driver 23 
LINK...: See MeSSage. 
network members 3 
network operation 4 
overview 3 

NO FILE ACTIVE: See Message. 

NO FILE ACTIVE ON LINK: See Message. 

NO FILES QUEUED: See Message. 

NO LINK ACTIVE: See Message. 

NO LINK DEFINED: See Message. 

NO LOCATIONS ROUTED: See Message. 

NO PORTS AVAILABLE: See Message. 

NO REMOTE PUNCH AVAILABLE ON LINK-- 
FILE PURGED: See Message. 

NO SWITCHED LINE AVAILABLE--LINK 
NOT ACTIVATED: See Message. 

nodes compatible: See Compatible 
Nodes. 

nonprogrammable remote terminals: 
See Remote Terminals, 
Nonprogrammable. 

NON-SIGNON CARD READ ON LINK: 
Message. 

NOT LOGGED ON: 

NOT RECEIVING: See Message. 

NOT ROUTED: See Message. 

NOT ROUTED--ROUTE LIMIT REACHED: 
see Message. 

NOW ROUTED THROUGH LINK: 

NPT, 

Signing on: 
NPT. 

starting: See Starting NPT. 
line driver 20 
messages; See Messages, 

NPT output file format 66 

NPT SIGNON card 64 

NPT-supported functions 20 

NPT-supported hardware products 


see 


See Message. 


See Signing On to 


NPT 


NPT NPT. 


nucleus: See VNET Nucleus. 
NUCLEUS CYL ADDRESS=: See Message. 


NUCLEUS WRITE COMPLETE: See 
Message. 

0) 

Operation, VNET system 47,49 


Operation procedures 59 
operator command usage: See 
Command Usage, Operator. 
operator commands; See also 
Commands, Operator. 
operator commands (remote station) : 
See Commands, Remote Station 


Operator. 
operator control: See VNET Operator 
Control. 
operator functions 
remote, SML 18 
remote, NPT 21 


VMB/VMC/NJI 24 
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See Message. 


VNET 24 

Operator (remote terminal) commands 
See Commands, Remote Terminal 
Operator. 

ORDER command: See Command, ORDER. 

output file processing 66 

output file processing (HOST mode) 

63 


P 


PARM control statement: See Control 
Statement, PARM 

PARM PREVIOUSLY SPECIFIELD FOR LINK: 
see Message. 

pasSing file to end user 12 
PASSWORD SUPPLIED ON LINK IS 
INVALID: See Message. 

pending files: See Files, Pending. 
PENDING FILES FOR LINK MISSING: 

See Message. 

FORT ADDRESS MISSING OR INVALID: 
See Message. 

PORT AVAILAELE: See Message. 

FORT control statement: See 
Control Statement, PORT 

FORT IN USE BY LINK: See Message. 
preloader 45 

products supported, VMB/VMC/NJI 
common factors 24 

FROGRAM CHECK-~LINK DEACTIVATED: 
see Message. 

PROGRAM CHECK IN SUFERVISOR--VNET 
SHUTDOWN: See MesSage. 
programmable remote stations 13 

programmakle (SPOOL MULTI-LEAVING) 
Stations: See Remote Stations, 
Programmable (SPOOL MULTI-LEAVING) 
protocol, symmetric: See Symmetric 
Protocol. 

FURGE command: See Command, PURGE. 


Q 
QUERY command: See Command, QUERY. 
R 


reader card formats for VM/370 
real reader 57 

RECEIVED FILE...: See Message. 

receiving a file from source 10 
RECEIVING FILE...: See Message. 

reconfiguration: See Dynamic 
Reconfiguration. 

REJECTED BY TASK: See Message. 
REJECTED EY TASK--NOT RECEIVING: 
see Message. 

rejected files 84 

remote job entry Station, VNET as 
a 240 

remote messages 103 

remote station commands: See 
Command, CMD. 

remote station operator commands: 
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See Commands, Remote Station 
Operator. 
remote stations 
ID card format: See IL Card 
Format From Remote Stations. 
Programmable (SPOOL 
MULTI-LEAVING) 199 
remote system messages: See 
Command, MSG. 
remote terminal operator commands: 
See Commands, Remote Terminal 
Operator. 
remote terminal processor program: 
See RTP Program. 
remote terminals 181 
nonprogrammable 13,181 
REORDER command: See Command, 
REORDER. 
reorganizing the transmission queue. 
See Command, ORDER. 
responses, 
command 171 
specific command 171 
responses to commands 
BACKSPAC 171 
CHANGE 171 
CLOSE 172 
CMD 172 
DEFINE 172 
CELETE 172 
DISCONN 172 
DRAIN 172 
EXEC 173 
FLUSH 173 
FORCE 173 
FREE 173 
FWCSPACE 173 
HOLD 173 
MSG 173 
ORDER 174 
PURGE 174 
QUERY 174 
QUERY ACTIVE 174 
QUERY DEF 174 
QUERY FILE STAT 175 
QUERY FILE VM 175 
QUERY FILE VNET 175 
QUERY FILES 174 
QUERY QUEUE 174 
QUERY SUM 175 
QUERY SYSTEM ACTIVE 175 
QUERY SYSTEM LINKS 175 
QUERY SYSTEM PORTS 175 
QUERY SYSTEM QUEUE 176 
QUERY SYSTEM ROUTES’ 176 


REORD 176 
ROUTE 176 
START 176 
TRACE 177 


TRANSFER 177 


restarting a line driver 69 


RESTRICTED COMMAND: See Message. 


resuming file transmission 100 


returned files, managing 84 
REWRITE THE NUCLEUS?: See Message. 


uv 


RJE mode 
file processing: See File 
Processing, RJE Mode. 
Signing on: See Signing On in 
RJE Mode. 
ROUTE command: See Command, ROUTE. 
ROUTE control statements: See 
Control Statement, ROUTE. 
ROUTED THROUGH LINK: See Message. 
routing table 27 
routing table, changing 70 
RTP program 200,208,220 


S 


Sample file transmission 10 

SENCING FILE...: See Message. 

sending file to next node 12 

SENT FILE...: See Message. 

shut-down: See System Shut-Down. 

SHUTDOWN command: See Command, 
SHUTDOWN. 

Signing on in HOST mode 61 

Signing on in RJE mode 61 

Signing on to NPT 64 

¢ign-on 177 

SIGNON OF LINK COMPLETE: See 
Message. 

SIGNON PARAMETER = ON LINK INVALID: 
See Message. 

SIGNON SEQUENCE ON LINK FAILED: 
see Message. 

SIGNON TYPE PARAMETER MISSING: 
see Message. 

SML line driver: See Spool 
MULTI-LEAVING Line Driver. 

SML messages: See Messages, SMI. 

SML output file format 63 

SML SIGNON card 61 

SML, Starting: See Starting SML. 

SMI-supported functions 17 

SML-supported hardware 17 

specific command reSponse: See 
Responses, Specific Command. 

Spontaneous messages: See 
Messages, Spontaneous. 

SEOOL command: See Command, SPOOL. 

spool MULTI-LEAVING line driver 16 

Spool system interface: See VM/370 
Spool System Interface. 

START command: See Command, START. 

starting line drivers 59 

starting NJI 68 

Starting NPT 64 

starting SML 60 

starting VMB 67 

starting VMC 68 

start-up: See System Start-Up. 

Stations 181 

stopping file transmission 99 

store and forward 3,8 

See also File Store and Forward. 
See also Network, Three-Node 
Store and Forward. 

stored commands 98 


Supervisor: See System Supervisor. 
Suppressing messages 55,124 
See also Command, HT. 
suspending file transmission: 
See Command, HOLC. 
Symmetric protocol 3,9 
System control tasks 16 
SYSTEM DISK ADDRESS=: See Message. 
SYSTEM ERROR READING SPOOL FILE: 
see Message. 
System operation: See Operation 
system shut-down 59 
system Start-up 59 
system status information 54 
See also Command, QUERY. 
system supervisor 15 


T 


tag 14 

TAG command: See Command, TAG 

tag slots 27,33 

TAGS control statement: See 
Control Statement, TAGS. 

TAGS COUNT MISSING OR INVALID: 
See Message. 

TAGS PREVIOUSLY SPECIFIED: See 
Message. 

TASK NAME ALREADY IN USE--LINK NOT 
ACTIVATED: See Message. 

three-node store and forward 
networks See Network, Three-Node 
Store and Forward. 

TRACE command: See Command, TRACE. 

TRANSFER command: See Command, 
TRANSFER. 

transferring a file 11 
transmission, sample file: See 
Sample File Transmission. 

two-level remote addressing 37 

two-node network: See Network, 
Two-Node. 


U 


UNDEFINED LINK ID: See Message. 
UNSUPPORTED SYSTEM RESIDENCE OR 
DEVICE TYPE: See Message. 
user commands: See Commands, User. 
user functions, 
virtual machines, NPT 21 
virtual machines VMB/VMC/NJI 24 
VM, SML_ 19 
user guide, VM/370 73 
USER ID MISSING OR INVALID: See 
Message. 
USER ID NOT RECEIVING: See 
Message. 
user mesSages: See Messages, User. 
USER NOT IN CP DIRECTORY--FILE 
SPOOLED TO SYSTEM: See Message. 


V 


VALID COMMAND RECOGNIZED ON LINK-- 


7 Index 253 


NO ACTION TAKEN: See Message. 
virtual machine: See VNET. 

virtual machine user functions: 
See User Functions, Virtual 
Machine. 

VIRTUAL STORAGE CAFACITY EXCEEDEL-- 
LINK NOT ACTIVATED: See Message. 

VMB line driver 23 

VMB, Starting: See Starting VMB. 

VMB/VMC/NJI common factors 23 

vMc line driver 23 

vec, starting: See Starting VMC. 

VM/370 networking 1 

VM/370 real reader, header card 
formats; See Header Card Formats 
for VM/370 Real Reader. 

VM/370 spool system interface 14 

VNET: See MesSage. 

VNET aS a remote job entry 
station: See Remote Job Entry 
Station, VNET aS a. 

VNET commands: See Commands, VNET. 

VNET components: See Components. 

VNET DIRECT: See Message. 

VNET dynamic directory: See 
Dynamic Directory. 

VNET directory control statements: 
See Control Statements. 

VNET DISCONNECTING: See Message. 

VNET installation: See Installation 
of VNET. 


254 VNET Reference and Operations 


VNET link attributes: See Link 
Attributes. 
VNET maintenance: See Maintenance. 
VNET messages: See Messages. 
VNET messages generated by more 
than one module: See Messages... 
VNET nucleus 41,42,44 
VNET operator commands; 
Commands, Operator. 
VNET operator control 9 
VNET operator functions: See 
Operator Functions, VNET. 
VNET preloader: See Preloaderx. 
VNET READY: See Message. 


see 


VNET system operation: See 
Operation. 

VNET virtual machine 7 

VNET virtual machine, definition: :) 
See Defining VNET Virtual 
Machine. 

VNET wait state codes; See 


Wait State Codes. 
W if 


Wait state codes 179 


wait states 55 


*x (comment) command: See Command, 
* (Comment). 
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